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I'm sure many of you read the "headlines" 
on the cover, they are very hard to miss! As 
I write this, I haven't received the subscriber 
list from UpTime , so I can't comment on how 
many new subscribers this will bring in. 

During an e-mail conversation with Jordan 
Tsvetkof, UpTime editor/publisher, he 
mentioned that he was considering folding 
UpTime this fall. He had only brought it out 
as a supplement to the Rainbow, mainly for 
advertisers who couldn't afford Rainbow's 
high rates. With the Rainbow gone and the 
more reasonable rates of 68' micros and The 
International OS-9 Underground, Jordan felt 
that UpTime had served its purpose. I decided 
itmightbe good for 68' micros to absorb those 
subscribers rather than let them get "lost" in 
the wayside. So we forged an agreement 
where I would continue UpTime 
subscriptions at my cost, which handily 
worked out to one issue of 68' micros for 
every two issues of UpTime. On a page 
count basis, this works out very well for 
former UpTime subscribers, as UT averaged 
8 pages per issue and 268'm averages 30 (and 
the page contents are more dense also). 

I hope you saw the notice in the contents 
column. First, the price increase has nothing 
to do with the UpTime merger. It is simply 
due to the costs and time necessary to produce 
a magazine of reasonable quality. I do hope 
you understand (I work for about $2.50 an 
hour to bring you this magazine!). I love the 
CoCo and OS-9 in all its forms, but I can't put 
the magazine out at a loss . On the other hand, 
I don't expect to make much either. Nicely 
breaking even, with just a little left over, will 
suit me fine! There should be no more price 
increases for quite a while, unless the US 
Postal Service has a major price hike (over .32 
for 1st class letters) or subscriptions drop 
below 200. In the later case, all will have to 
be mailed via first class postage, which means 
an additional .50 per issue ($4 per year). That 
means rates would have to increase to $28 per 
year. If this happens, the increase will be 
effective with the next issue, which means all 
subscribers would receive renewal notices 
one issue earlier than the year before. Ill take 
absorb the remaining $1 per subscription. 

Now I have to get something of f my chest. 
I make every effort to keep readers informed 
about what is going with 68' micros, including 
some financial information on occasion. This 
is YOUR magazine! !! Butl#£££ feedback 
and even criticism from you, so WRITE! 

I was really disturbed by two notes rccendy 
received in the mail. Both were from people 
who let their subscriptions expire. I had sent 



renewal notices asking for a reason if 
subscriptions were not renewed. These two 
decided to let me know. 

What really upset me was the fact that 
they didn't write earlier, when something 
could be done about their complaints. It 
takes at least two issues for changes to be 
incorporated in most cases . Some I can make 
effective immediately, depending on how 
much work has progressed on the current 
issue and how close it is to going out 

These people did no one any good, 
especially not themselves, by dropping their 
subscriptions. If they had written and let me 
know what they weren't getting, they could 
have easily been accommodated. For the 
record, the complaints were not enough 
Color Basic specific support and no more 
Swap-Shop. 

The last issue saw reaffirmation of Color 
Basic support 111 have program listings in 
every issue from now on while continuing 
the current amount of OS-9/OSK support. 

I simply was not getting enough response 
to have a dedicated classifieds section. 
Classified ads will appear in "micro notes" 
(formerly "Micro News") from now on as 
readers send them in. 

But those two who let their subscriptions 
expire rather than write and letme know they 
had complaints will never know of these 
changes. And subscription rates may rise in 
the future for all those who continue because 
those two (and others who won't write and 
let me know theiweeds) are no longer 
subscribers.. 
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FARNA Systems has set aside 

some cash and prizes ($150 total!) 

for a programming contest! 

ALL COMPUTER TYPES 

SUPPORTED BY 68'mlcros 

ARE ELIGIBLE! 



Send a disk with a runn ing copy of the program 
as well as an ASCI I listing of the source code 
or BASIC listing, running/installing instructions, 
and a descriptionto FARNA Systems PC, Box 
321, WR, GA 31099 by January 1st, 1995. 
Programs may be of any type. 



First place gets $50 cash, 
Second place gets $251 
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Letters to the Editor 



I have a question about ADOS: will it 
give you a logical 360/720K disk drive 
(40/80track double sided), or just two 
1 80/360K (40/80 track single sided) disks 
back to back? Are there any other ROM 
tricks that will give you one logical 360K 
or720KdiskalaMS-DOS? 

Now I would like to share some private 
thoughts on our little CoCo. I'm pleased 
that I own a fairly nice home, one that 
takes a good deal of my weekend time at 
least Which do I think about more, home 
or CoCo? The question hardly needs to 
be asked! How can this be -it's just a 
little machine, right? Just plastic, circuit 
boards and silica chips, right? Balance is 
a good idea — we've got trees, a lawn, five 
dogs, and seven cats (anyone close by 
can have some!) to tend to. A 1982 
concord and a Significant Other, thank 
God. Should balance be so hard? 

Fortunately, I count my blessings in 
having met you, Zack Sessions, Tony 
DiStefano, Alan Huffman, Rick Ulland, 
and Colin McKay; the depth of your 
collective understanding and ability is 
awesome. Adding Bob van der Poel, 
Marty Goodman, and Matt Thompson, 
this is an incomparable collection of 
souls. Overall, I feel truly enriched to 
have met any of ya'll. You are the spirit 
and soul of the CoCo community. 

Henry Harwell 

21 10 W.Roma Ave. 

Phoenix, AZ850154445 

First of all, thanks for the kind words, 
Henry! I'm sure the other writers and 
vendors appreciate the comments also. 
I did edit your letter rather severly, as 
much of it was directed to me personally. 
I do hope you don't mind that I shared 
some of your comments with the readers 
though, especially those about the other 
vendors and writers. 

As for ADOS: the problem is the CoCo 
disk system itself. There is only room for 
a maximum of 78 file entries, so even if 
you could address both sides of a disk 
at once (MS-DOS does it by alternating 
sides... a file is written to track side 1 
then track side 2, track 1 side 1 , track 
1 side 2, etc.), you would be limited to 
78 files total. Since most CoCo files are 



small, that would sure be a waste of 
space! Note that this problem persists 
with 80 track drives. The only purpose 
I can personally see for using 80 track 
drives with ADOS is that they are 
already on the system for use with OS- 
9, which can take full advantage of the 
capacity. At least one standard 35140 
track drive would be needed even then. 



Want to let you know I received Vol.2 
#3 following our renewal "checkup". 
The bad news is that I never received 
Vol.2 #2. I hope you can rectify this 
ommission. 

I also have a question about RGB- 
DOS. I run a DS/DD 5.25" driveand two 
3.5" 720K drives. I would like to partition 
the 720K drives into four 35 track drives 
each under DECB, much like RGB-DOS 
does with a hard drive. That would allow 
me much more efficient utilization of my 
disks with Max- 10 and other DECB 
applications. As you know, Max- 10 
won't run under Hyper I/O or the double 
sided pokes. 

Ray Watts 
Box574 
NianticCT 06357 

Ray, a copy of the missing issue is on 
its way! As far as I know, what you are 
asking is not possible. RGB-DOS only 
addresses the hard drive itself as 
multiple floppies, it wouldn't work with 
the floppy drives themselves. The only 
thing I can think of that would partially 
rectify your problem is Extended ADOS 
3. It allows mixing of drive sizes, so you 
could have your 3.5" drives set up as 
two 360K drives. You can even have 
different configurations, so you could 
take the 525" offline and use the two 
35" drives only (as the four allowable 
drive numbers). 
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Letters arc printed on a space available and 
popular subject matter basis. If you don't want 
your letter printed, or wish to withhold your 
address and/orname t please state so when writing. 
In some cases, letters arc edited for space and/or 
clarity. If a personal reply is desired, please 
enclose an SASE. 



MM/1 Update 

Daivid Graham 

Greetings, and a Happy Holiday 
Season to you and yours! We at 
BlackHawk Enterprises, Inc. are 
continueing to make progress with 
new products for your MM/1 . A beta 
version of SpareRiBBS went into test- 
ing late in November and we hope to 
release in January, or perhaps as early 
as Christmas! SpareRiBBS is the 
shareware version of John 
Donaldson's RiBBS port, which will 
be followed in April by a more pol- 
ished and capable commercial release 
of K-RiBBS. John is going to be a 
busy camper during the next few 
months, as he will also be working on 
upgrading K-Term to add 
Compuserve-B protocol and improved 
ANSI screen controls, among other 
things yet to be determined. Look for 
us at the Chicago CoCoFest in April! 
We also have acquired sourceing for 
Sony 's CPD-1 302 monitor. No longer 
produced, these are refurbished units. 
At $225 it is hard to find a better buy, 
as these monitors sport a .26 dot pitch 
and deliver an outstanding display on 
your MM/1 ! We can also offer tape 
backup drives for as low as $175 used 
or $425 new - though our sources for 
used tape drives are not as stable as 
that for the monitors. 

Work on getting MM/1 I/O boards 
to production continues, with Kevin 
Pease, Ray Patterson and Joel Ewe 
working together to isolate problems 
with the MM/1 SCSI sub-system. 
Progess is being made, and we hope 
to have more news for you by next 
month. In the mean time - 

Merry Christmas!! 

< 268'm > 



BlackHawk 

Enterprises, Inc. 
Supporting the 
MM/1... 
now and in the future! 
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The Fifth Annual Atlanta CoCoFest 

Southern spotlight on the CoCo, OS-9, and OSK! 



Colin McKay 



ATLANTAjGA: Once again another Al- 
lan la Fest has come and gone. For those who 
were unable to attend, I've prepared this 
report on the Fest. Those of you on elec- 
tronic services should also keep your eyes 
open for Allen Huffman's Fest Report, for 
a slightly different perspective. 

The Trip Down 

This time around Ken Scales, Jim Pottage 
and I went down to the Atlanta Fest in Jim's 
car. Apart from an interesting conversation 
with US Customs ("Please pull into bay 
#2"), the trip down was uneventful (While 
the North American Free Trade Agreement, 
or NAFTA, has aided trade for big business, 
it has also imposed an additional burden in 
terms of paperwork for small businesses, 
such as Northern Xposure. Hardware in 
particular has become difficult to take across 
the border, though sending it by mail is 
relatively straight- forward). Twenty three 
hours later, we arrived at the hotel. 

Attendance seemed down once again, but 
sales were still pretty good, especially for 
those who had new products available. Those 
without new products quickly discover that 
people will only buy a product once! No 
cheerleader convention at the hotel this year 
either (OK, so they were a little young, but 
it sounds good)! Business was steady on 
Saturday, and hectic Sunday morning, but 
Sunday afternoon was pretty quiet as people 
began the journey home. 

Sincere thanks to the Atlanta Computer 
Society (ACS), our hosts for the Fest. The 
show, as always, was well run. Anyone 
thinking of putting on a show in their region 
should strongly consider contacting either 
ACS, or the Glenside Club, which hosts the 
Chicago Fes is . Once again ACS negotiated a 
substantial discount on the regular hotel rates 
for those who stayed at the Holiday Inn. 

The Vendors 

Did my best to make it around to all the 
vendors this time, to see what they had to 
offer, and made purchases when I found 
interesting items. While my interests lie pri- 
marily with OS-9/68000 software, I tried to 
cover both DECB and OS-9/6809 products 
as well. 

Twenty-six vendors were scheduled to 
attend, with a mixture of old and new prod- 
ucts. Some quick changes were made when 
some vendors had to cancel at the last minute, 
and some additions were also made. This was 
the largest number of vendors ever at the 
Atlanta show. I've noted the vendors here, 



along with product highlights from each one. 
The vendors at the Fest were: 

Adventure Survivors (Lin & Nan Padgett) 
— They now have the Power Stones of Ard 
(Ard I & II) available. The Padgetts produce 
a bi-monthly newsletter for adventure game 
lovers, and are a great source for adventure 
solutions . 24 Perthshire Dr, Peachtree City, 
GA 30269 (404)487-8461 

Kala Software (Ed Hathaway) — unable 
to attend due to family emergency. Has 
UltiMuse music generating software (MIDI) 
for OS-9 and OSK. 3801 Brown Bark Dr, 
Greensboro, NC 27410 (910)294-1558 

Delmar Company (Ed Gresick) — unable 
to attend due to industrial business. Sells the 
Sytem IV and System V OSK systems and 
G -Windows for these and OS-9000. POBox 
78 I Middletown Plaza, Middletown, DE 
19709 (302)378-2555 

Northern Xposure (Colin McKay et al) 
NitrOS -9 v 1 .20, an intermim release pending 
v 1.21, was available. Bob van der Poel soft- 
ware and White's Speedisk for OSK were 
also available. 7 Greenboro Cres, Ottawa, 
ON I Canada I KIT 1W6 (613)736-0329 

Hawksoft (Chris & Nancy Hawks) — 
Updates to Sound (now called WAVES) & 
CD Player (UCDP), both for the MM/1, 
were available. 244 S Randall Rd, Ste. 172, 
Elgin, 1L 60123 (708)742-3084 

SBUG (Andre Lavelle) — Lot's of com- 
puter stuff, of every shape and size! 1251 W 
Sepulveda Blve #400, Torrence, CA 90502 
(310)539-9702 

OS-9UsersGroup,Inc. — The booth was 
manned by Carl Boll and Howard Luckey . A 
CD-i demo machine was running throughout 
the fest, and some literature describing indus- 
trial OS -9 products was also available. 6158 
W 63rd St, Ste 109, Chicago, 1L 60638 
(312)735-6087 

D ALTRUG (Lee Veal) — Planet Engine 
(OS -9 Astronomy program) was again avail- 
able, along with Cosmic Jewelry made by 
Lee's wife. A port of Planet Engine to the 
MM/1 is in the works. 833 Woodhaven 
Lane,Grand Prairie, TX 75052 (214)264- 
3610 

Glenside Color Computer Club — This 
booth was manned by Brian Schubring & 
Tony Podraza from GCCC. They were tak- 
ing memberships to the club that sponsors 
the Chicago Fest. 119 Adobe Cir, 
Carpentersville, 1L 60110 (708)428-3576 

Digital Frontier Productions (Eric 
Crichlow)— Gold Runner 2000 forthcMM/ 
1 and Digger for OS -9 were available (similar 
to old CoCo Gold Runner). These first- 



timers did good business, and were impressed 
by the show. All the proceeds from Gold 
Runner 2000 went towards purchasing an 
engagement ring for Eric's girlfriend, 
Stephenie. Good luck, Eric! 2300 W San 
Angelo #2070, Gilbert, AZ (602)892-2161 

CoNect (Rick Ulland) — unable to attend 
due to car trouble. See ad in this issue. 449 
South 90th St, Milwaukee, Wl 53214 
(414)258-2989 

FARN A Systems (Frank S wygert) — 

Frank was selling 268 'm subscriptions, 
along with the new CoCo Family Recorder/ 
OS-9, and KenTon SCSI interfaces. Winner 
of the biggestbanner award! Box321, Warner 
Robin, GA 31099 (912)328-7859 

RC Smith "Gently Used Hardware & 
Software/' 524 MartinRd, Stone Mountain, 
GA 30088 (404)469-6601 

Al Dages "Gently Used Hardware & 
Software." 4894 Candlewood Ln, Stone 
Mountain, GA 30088 (404)469-5111 

Atlanta Computer Society Club Sales 

Our Hosts (Thanks, folks!) POBox80694, 
Atlanta, GA 30366(404)636-2991 (BBS) 

Wittman Computer Products (Bill 
Wittman) — The WCP306 Computer Proto- 
type was available for viewing. This machine 
will be sold by several vendors, under differ- 
ent names. Expected shipping date for these 
machines is December 94, so write for de- 
tails. New at the Atlanta Fest were InfoXpress, 
Desktamer, LATerm, and theTVP Point-of- 
Sale system. 873 Johnson Rd, Churchville, 
NY 14428(716)494-1506 

Eugene Adams "The Color Computer 
Philanthropist!" — Eugene was giving away 
some of the older CoCo2s he has collected, 
along with some software. 1 35 Lloyd Dr, 
Marietta, GA 30066 (404)422-3097 

Mid Iowa & Country CoCo (Terry 
Simons) — Upgrade Disk Magazine sub- 
scriptions with MI&CC memberships were 
available. Home-Pac OS, the OS-9 Home 
Manager was also available. 1328 48th St, 
Des Moines, 1A 50311 (515)279-2576 

Rick's Computer Enterprise — Back 
again with programs for DECB from Sun dog 
Systems, as well as CFDM subscriptions 
and a variety of DECB software from now 
defunct CoCoPro! Rick also displayed the 
new CoCo 3 emulator on his 486 laptop. 
PO Box 276, Liberty, KY 42539 (606)787- 
5783 

JoT A Productions (Tim Johns) -Tim had 
available his recently completed sound driv- 
ers for the Delmar System V. Those of you 
with Delmar machines should givcTim acall 
— the driver works great through the built-in 
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speaker on these machines. Sound blaster 
support is planned. Some other projects "in 
the works" should be available in Chicago. 
PO Box 4657, Nacogdoches, TX 75962 
(409)560-1876 

Klystronics — Written words couldn't do 
this product justice. They ran out of Klys- 
trons early in the show, but promised to 
bring more to Chicago. Once again, I missed 
the chance to meet these people, as they left 
early on Sunday, and all the business cards 
on their table were gone. (Address not 
available.) 

Strongware (John Strong) — For the 
MM/1, S Paint & Graphics Tablet support 
were available, in addition to their other 
programs for OS -9/6809. John also remarked 
that "It was a pleasure meeting the 
Klystronics rep". PO Box 361 i Matthews, 
IN 46957 (317)998-7558 

Sub-Etna Software (Allen Huffman & 
Terry Todd) — New were Invaders09, and 
the Blobs top pack — hardware and software 
modifications to correct the BLOB prob- 
lems reported on some systems. Updates to 
other programs, such as Towel, MultiBoot, 
and the Fest game were also available. Allen 
also had a photo album covering all the Fests 
since 1990. Please note that the telephone 
number printed in the Fest guide is for 
Allen's Grandmother — please don't use it! 

PO Box 152442, Lufkin, TX 75915 

Blackhawk Enterprises (DavidGraham) 
— "Home of the MM/1" New 8 Meg up- 
grade Cards were being shown. (David did 
note that Klystronics seemed to be generat- 
ing a LOT of attention.) PO Box 1 0552 , Enid, 
OK 73706 (405)234-2347 

Roy Shoaf — "Gently Used Hardware & 
Software." 293 W Junction Ct, Kennesaw, 
GA 30144 (404)928-4047 

Color Systems (Zack Sessions) — 
KChess (a GNU Chess interface for the 
MM/1), and the X 10 Home Contoller soft- 
ware were new to Atlanta. With his profits 
from KChess sales in Chicago, Zack pur- 
chased a flatbed color scanner, and was 
scanning images for all who asked. (Thanks, 
Zack\)POBox540,CastleHayne,NC 28429 
(910)675-1706 

Nobody (Scott Proctor) — Sale of surplus 
& spare equipment Note: Scott runs 
"Nobody's HomcBBS" POBox884,Ocala, 
FL 34478-0884 (904)245-9396 (904)245- 
6585 (BBS) 

Ron Bull — Sale of surplus & spare 
equipment. 775 Ann St, Duncannon, PA 
17020-1204(717)834-4314(717)834-4071 
(BBS) 

Don't forget to write or call vendors to 
request a catalogue or more information if 
anything above catches your interest. All the 
vendors carry many more item's than I've 
listed here. 



The Lectures 

This time I abandoned my booth, and 
managed to attend two of the lectures — the 
ones given by Kevin Darling on Saturday, and 
Boisy Pitre on Sunday. 

Saturday 

1:00- 1:55 "Supporting the CoCo: The 
Next Step" by Allen Huffman. The main 
point was to encourage people to RESPOND. 
Write magazines to let them know what you 
think, tell vendors if you like their programs 
(or if you dont!), contribute articles, letters, 
code, etc. Get involved to keep things going. 
This is a major problem right now - people 
leave due to a perceived lack of interest by the 
community. 

2:00- 2:55 "CoCo Hard Drives" by Frank 
Swygert, Frank talked about the different 
types of hard drives curmetly in use and also 
plugged the Ken-Ton units he is now selling 
(the only ones still being made). Also dis- 
cussed cost of adding a hard drive to CoCo. 

3:00-3:55 "Open OS-9 ForunTby Kevin 
Darling. Those who attended were updated 
on Kevin* s current career writing software 
for video gambling systems. Look for an 
article in an upcoming issue of the OS -9 Users 
Group newsletter (MOTD) and a shortened 
version 268'm about these machines. 

Sunday 

10:00-10:55 'The Future of Desktop OS- 
9" by David Graham. David discussed a 
variety of topics during this seminar, enough 
that I gave it a separate section below. 

11:00-11:55 "Graphics and Game Pro- 
gramming Forum" by John Strong. Once 
again John outlined how to create a game, 
from early concept to final product. 

1 2:00- 1 2:55 "Inside CD-i" by Boisy Pitre 
A fascinating demo of the capabilities of the 
CD-i machines. Boisy also demonstrated his 
bootable CD-i disk which gives shell access 
on aCD-i machine via a terminal. Tne videgame 
"Dragon- slayer", with the exploits of Dirk 
Daring, was one of the recent titles released. 
It really is an interactive cartoon/adventure! 
(And one of my all-time favourites.) 

The Future of Desktop OS-9 

To begin his seminar, David Graham de- 
fined anew term : Desktop OS -9. This means 
any Personal computing or host develop- 
ment use of OS-9. (Author's note: While 
David is referring to OS-9 in general, OS-9/ 
68000 was the primary emphasis in his semi- 
nar.) He did note that the past history has 
been rather dismal, but things are looking up. 
Four new terminal programs have appeared 
over the last year, and one new terminal 
program and a major database (Fo xBase com- 
patible) will be coming this year. Some very 
nice games arc out now — noteably Gold 
Runner 2000 by Eric Crichlow. A lot of 
projects arc also in the works, including a CD 



File manager and other multimedia programs 
to be completed during next year or two. 

Program capability is increasing as people 
become more familiar with OS-9/68000 and 
Desktop vendors are banding together to 
assure more software of higher quality in 
more timely fashion. The Desktop OS-9 
Developers and Marketing Association (un- 
official name) is being formed to provide 
formal support for these activities. David 
noted that the MM/1 will return to full 
hardware production within 1 month, with 
new backplane available at the Fest. 

A new machine, the MM/IB based on 
68306 boardby Carl Kreider will be available 
late 1994/early 1995. This is the same ma- 
chine described above under Wittman Com- 
puter Products as the WCP306 (see the 
November issue, "Nine Flavors of OS-9; 
AT306" for details). Essentially it is a 1 6MHz 
68306 board with six PC/AT 1 6 bit slots and 
connectors for two IDE drives and two 
floppy drives. A VGA/SVGA card is used 
for graphics. OS-9/68000 v3.0 is included, 
along with the MGR windowing package. 
Price for the motherboard and software is 
expected to be in the $400.00 range — a 
fantastic price! 

Following the same theme as Allen 
Huffman mentioned in his seminar, David 
also emphasized the need for better commu- 
nication between users and authors/vendors. 
Users must ask for they want, and pay for 
it when they get it. There have bee too many 
episodes of users saying they want some- 
thing, and not buying it when vendor does 
supply it (Tape drives, CD-ROM drives 
example) - and vendors must supply better 
quality merchandise. 

David emphasized the importance of gain- 
ing new users and making inroads intoother 
markets by accelerating developement and 
becoming moreprofessional.Cultivating real 
time and embedded systems people is a 
must. Look for bigthings in next 1 to 2 years. 

Chicago 95 

Not related to Windows95, the Fourth 
Annual 'Last* Chicago CoCoFcst is sched- 
uled for 29-30 April 1995. Be there, or be a 
right-angled equilateral quadrilateral! 

Colin McKay 
Northern Xposure 
cmckay@northx.isis.org 

(Palindrome... beta version) 
(Think about it a while!) 
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Announcing the 

4th Annual" Last" 
Chicago CoCoFest 

April 2j> & 30, 1^5 




SMALL GRAF X ETC. 



M Y" & 'TRT cables. Special 40 pin male/female end 

connectors, priced EACH CONNECTOR -— — - $6.50 

Rainbow 40 wire ribbon cable, per foot $1 .00 

Hitachi 63C09E CPU and Socket -- $13.00 

512K Upgrades, with RAM chips $72.00 

MPI Upgrades 

For all large MPIs (PAL chip) — - $ 1 0.00 

For small #26-3124 MPI (satellite board) $10.00 

Serial to Parallel Converter with 64K buffer, cables, 

and external power supply — $50.00 

2400 baud Hayes compatible external modems $40.00 

ADD$2.00S&HTO EACH ORDER 

SERVICE, PARTS, & HARD TO FIND SOFTWARE WITH COMPLETE 
DOCUMENTATION AVAILABLE. INKS & REFILL KITS FOR CGP-220, 
CANON, & HP INKJET PRINTERS. RIBBONS & Vcr. 6 EPROM FOR 
CGP-220 PRINTER (BOLD MODE), CUSTOM COLOR PRINTING. 

TERRY LARAWAY, 41 N.W. DONCEE DRIVE 
BREMERTON, WA 98310 206-692-5374 



Show Hours: 

Sat., April29 10:00AM-6:00PM 
Sun., April 30 10:00AM-4:00PM 

Admission: 

$5.00 in advance, $8.00 at door 
(2 day pass only, order before 16 April) 

Address for advance tickets: 

Tony Podraza, Fest Coordinator 

119AdobeCircle 
Carpenters vilIe,IL 601 10-1 101 

Reservations: 

1-708-695-5000 
1-80CW654329 

Sponsored by: 

Glenside CoCo Club 

Vendor Information: 

Booth Price: $35 ($30 for 2nd) 

Member Price: $30 

(Membership can be purchased at 

registration -- $15 per year) 

Reservations must be received no later 

than 3/25/95. Deposit of $20 per booth 

required with balance due no later than 4/ 

26/95. Balance received after 4/16/95 

subject to a 20% late fee. Vendor setup 

Sat, April 29 5:30AM-9:45AM 



DONT FORGET TO 

RENEW YOUR 268'm 

SUBSCRIPTION 

EARLY! 

As of 01 Jan 95, rates will 
increase to $25 for 
domestic mail (no change 
for Canada and Mexico). 
We will accept renewals 
for the next year (one year 
only) from current 
subscribers until 01 
February 1995. Sorry for 
the inconvenience, but we 
do want to continue 
offering you the quality 
support you deserve! 
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BASIC in Color 

BASIC Support for the CoCol 



Fred Remin 



Many of you still use and enjoy 
Tandy's Extended Color BASIC and 
Disk Extended Color BASIC (I'll use 
DECB to refer to both from now on). 
Several readers have asked for more 
DECB articles, so I've decided to start a 
column specifically fqr BASIC users. 

There is one thing I want to get clear 
right from the start. This is YOUR 
support column! If you don't write, call, 
or send me e-mail, I won't have anything 
to put here. I will devote space in each 
issue exclusively to DECB, but don't 
make me print a blank page because 
nothing has been sent in! 

NO topic is to simple. Even tips on 
how best to use a tape recorder would 
help someone. And don't think you 
shouldn't cover something that has been 
covered pretty well in past magazines. 
There are many out there who are just 
starting with their handed down CoCo, 
so there are no subjects that "everyone 
knows"! Remember the one and two 
liners from Rainbow? Little things like 
that will make interesting fillers 
throughout the magazine. 

I need your input to keep this column 
as a regular feature. I also need a better 
name. Let me know what you think 
would be a better name for a DEC B only 
column. 

Since I really have nothing else to 
cover in this issue, I'm going to start 
with a beginners tutorial. This tutorial is 
reprinted with permission from 
Australia's only CoCo magazine- 
CoCo-Link. This will run for the next 
one or two issues, but don't let that keep 
you from sending in submissions now... 
I need time to plan each issue's contents! 

I'm going to start this new Basic 
support column with a beginners tuto- 
rial. This tutorial is based on a scries 
printed in Australia's CoCo-Link 
magazine (written by Fred Remin). 
My apologies to Fred for all the edi ting 
and adding ! (There was nothing wrong 
with the original articles, I just wanted 
to add and rearrange some of the info.) 



What is a CoCo? 

"CoCo" is the affectionate name 
given to the Tandy Color Computer 
and encompasses the original Color 
Computer (usually referred to as the 
CoCo 1), the Color Computer 2, and 
the Color Computer 3. This name was 
unofficially given to the Color Com- 
puter by Dave Lagerquist (editor/pub- 
lisher of the late "Chromasette" maga- 
zine on tape) in October 1980. Tandy 
soon followed suit by referring to the 
machine as the CoCo in several of their 
publications and later manuals. 

The original CoCo was grey in color. 
It contained Color BASIC (no ex- 
tended) in 8K of ROM and had 4K of 
RAM, all for $399.00. It was expand- 
able to 16K of ROM (Extended Color 
BASIC) and 16K of RAM. 

The next CoCo was the CoCo 2. It 
had a white case which was shorter 
(front to back) than the original. It 
came with 8K ROM and 16K RAM 
and was upgradeable to 16K/64K, re- 
spectively. 

The CoCo 3 finally debuted in 1 986, 
six years after the first. With this 
model we finally got an 80 column text 
display, high resolution color graph- 
ics, and more memory! The CoCo 3 
came with 16K ROM (extended BA- 
SIC was standard) and 128K of RAM. 
Tandy also offered and upgrade to 
512K (also offered by other vendors). 
Disto even offered a 1MB and then a 
2MB upgrade, though these aren't very 
useful for BASIC programming. 

How much memory do I have? 

One question often asked of me is 
"how can I tell how much memory my 
system has?". A quick way of doing 
this, once booting (turning on) your 
system, is to type in the following: 
PRINT MEM <entcr> 

The result shown on the screen will 
give you a ROUGH indication of the 
amount of RAM that you have, e.g.: 
Around 4,000 = 8K RAM 
Around 8,000= 16KRAM 
Around 16-18,000 = 32K RAM 



Around 22-28,000 = 64K RAM+ 
Even though you have a 128K or 
512K CoCo 3, it will still only give a 
result between 22-28,000. This is be- 
cause a copy of the CoCo 2 ROM is 
used. All CoCo 3s came with 128K 
RAM from the factory. Look inside 
the system through the slots at the top 
left corner. You will see either some 
empty white connectors or a small 
circuit board close to the top of the 
machine. If the circuit board is present 
you have a 512K machine. If a Disto 
1 MB or 2MB upgrade is present, there 
will also be a circuit board near the top 
of the machine visible through the slots 
on the right. 

Setting up your system 

The first thing to do is to determine 
where you are going to have the sys- 
tem set up. For example, when I first 
started I used the family TV but this 
became a real nuisance when the kids 
wanted to watch TV, so now I have a 
separate area for my system. Some of 
the things you should consider are: 

a. Power points (outlets). How many 
power points will you need for your 
system? Take into account the com- 
puter, tape and/or disk drive, TV/moni- 
tor, printer, multipak, and any other 
peripherals that you may have or need 
in the future. It is generally a good idea 
to get a six outlet power strip. Then the 
entire system can be turned on and off 
at once, and this is usually enough 
outlets. 

b. Distractions. Is the system in the 
main path between the front door and 
bedrooms or in full view of the TV? It 
is best placed where there are a mini- 
mum of distractions so that you can get 
on with enjoying your computer. 

c. Ventilation. As your system is 
operating it is generating heat. Make 
sure there is adequate ventilation 
around the computer. If it is stuck in a 
tight nook on a computer desk, you 
may need a small desktop fan blowing 
across it and the disk drives to provide 
adequate cooling. Except in extreme 
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cases, the CoCo will stay cool on an 
open desktop without additional cool- 
ing. Intermittent errors for apparently 
no reason are usually caused by lack of 
cooling, especially if the errors only 
occur after 10-15 minutes of opera- 
tion. The older models are more sus- 
ceptible to heat than the 3. 

d. Space. Is the space you have se- 
lected going to allow you to expand? Is 
there room for all you need, and maybe 
that printer you have yet to get? You 
also need room for books, disk, tapes, 
and magazines. You want to keep a 
copy of "68* micros" handy! 

e. Phone! Is the system close to a 
phone? This will come in handy for 
when you have a problem and you 
want to ring someone for help. It will 
also come in handy when you get a 
modem added to your system for ac- 
cess to the "Information Highway". 

f. Lighting. Unless you want to dam- 
age your eyes, I would suggest that you 
have adequate lighting. At the same 
time, ensure that any light is not di- 
rectly on your screen. This can be a 
real distraction can make it hard for 
you to properly see the screen. 

By taking the above into consider- 
ation, and a few more you may think of 
yourself, you will ensure that you have 
many enjoyable hours at your com- 
puter. 

Media handling 

Whether you use tapes or disks you 
MUST be aware of any magnetic field. 
DO NOT place your tapes or disks 
directly next to or on top of any elec- 
tronic device. The magnetic fields gen- 
crated could cause some of the data on 
the data to be destroyed. Most com- 
puter equipment is usually shielded 
enough to prevent damage, but don't 
take any chances! If you are using a 
TV, stay clear of the left side (facing 
TV, your left). This is where the flyback 
transformer is in most TV sets. That 
transformer creates quite a magnetic 
field and wasn't shielded to be around 
disks and tapes! 

Before you turn it on 

The next step is to READ THE IN- 



STRUCTIONS that came with your 
system ("Introducing Your Color Com- 
puter") on how to connect everything. 
All the ports on the back of the CoCo 
are clearly marked, so if you don't 
have the manual this is generally no 
problem. One thing that you MUST 
remember, however, is to NEVER, 
EVER remove or insert a cartridge, 
multipak, or disk drive controller in 
the side of the CoCo with the power 
on! This could cause the 6809 proces- 
sor to blow. Most "dead" CoCos are 
caused by this simple mistake. Don't 
bump or wiggle anything in the slot 
after the power is on. This isn't as 
important if you are using a multipak, 
as the multipak has buffers to prevent 
damage to the computer. You could, 
however, damage the cartridge being 
inserted. 

Memory and BASIC version 

The amount of memory available to 
you I have already discussed above. 
This will determine what programs 
will or will not work on your machine. 
For example, a game which requires 
128K to operate will not work on a 
64K CoCo. Any program that works 
on a CoCo 1 or 2 will usually work on 
a CoCo 3 , but not the other way around. 

Another problem area with the CoCo 
1 and 2 is the version of BASIC in- 
stalled on your machine. A program 
which requires "Extended Color BA- 
SIC" will not work on a "Color BA- 
SIC" machine. The version of BASIC 
will appear on the first line of your 
screen when the computer is first turned 
on without a game cartridge. If a disk 
controller is in the cartridge slot, the 
word "Disk" will be added to the 
message. CoCols and 2s will have 
BASIC version 1 while CoCo3s will 
have version 2. Version 2 will gener- 
ally run all version 1 programs. 

If your computer display s something 
other than a BASIC version, you have 
a modified ROM. The most popular 
modification is to add something called 
ADOS, Since even ADOS is 
customizable, you need to get in touch 
with the computer's previous owner if 
possible to determine what options 



were installed. If you can't reach the 
owner, write and I'll try to help. 

Tape versus disk storage 

You should be aware that the CoCo 
can use tape, disk, or both as a means 
of information storage and retrieval. If 
a disk system is attached to your CoCo 
you will lose about 4K of memory (this 
is used by disk BASIC). Because of 
this some tape programs will no longer 
run. Some can be "offset loaded" with 
a disk to tape utility and be made to run 
from disk, while some cannot. 

The "advantages" to using tape is 
that it is cheap and works with ROM 
paks. The disadvantage is that it isn't 
always reliable and it is SLOW. Reli- 
ability improves with tape quality, so 
always use at least mid-grade tapes of 
the shortest length available. NEVER 
try to use the cheap "3 for $2" audio 
tapes! ALWAYS make at least two 
saves of any program or data with 
some blank tape in between saves, just 
in case! 

Disk drives are really convenient if 
you intend to use your computer a lot. 
In the old days, there was good reason 
to use tape instead of disk, as a disk 
system cost much more than the com- 
puter (in 1983, an Extended BASIC 
CoCo 2 was S3 1 9.95 and a single disk 
drive and controller was $499!). Now 
they are about the same, with used 
single disk system going for $5,000- 
$75.00. For the best games and appli- 
cation programs, disk drives are amust! 
So if you don't have a disk system do 
be on the look-out for one. If you can't 
find a used one in your area, send an 
SASE to "68* micros" and I'll see what 
I can find for you. 

Next time... 

We have covered the basics of set- 
ting up the CoCo in this article. Next 
time we will get a little deeper into the 
actual operation of the machine. If you 
need any equipment let me know. Save 
the operation questions for the next 
issue! 

<268'm> 
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The Industrial OS-9 User... by Ed Gresick 



WINDOWS 



Last month I presented an overview of G- 
Windows and its origin. This month Til 
present my usage of G- Windows for my 
business. I may be at the computer 12 or 
more hours a day, day after day. I don't want 
to waste time waiting for the computer or 
search ing for inform ation . Comfort is para- 
mount. Most of the time, I can't just stop 
working and take a break or relax. Andlcan't 
afford eye strain - these old eyes just can't 
take it. 

Since I spend considerable time on the 
phone, I've switched to a cordless, headset 
phone leaving my hands free forother activi- 
ties and giving me mobility. The point of all 
this is simply that I won't be a slave to 
machines be they computers, phones or 
whatever. Rather, they are to serve me. 

I have four machines running G-Win- 
dows. A SYSTEM IV (68000/1 6 MHz) - 
my 'business' machine, a second SYSTEM 

IV which is also equipped with an ALT86 
card for running MS-DOS and used as a 
demo, a SYSTEM V (68020/33 MHz but 
sometimes at25 MHz) and a 486DX2® 66/ 
33 MHz running OS-9000. The SYSTEM 

V and 486 are used for programming and as 
demos. 

I have a third SYSTEM IV used to run my 
retail store. The later system is not equipped 
with a VGA card or keyboard hence cannot 
run G-Windows - it is configured as a serial 
system and has 8 serial ports. I still run my 
CoCo 3 butonly for UUCP (MarkGriffith's 
version) but it is destined to be retired soon 
when I start using the UUCP port to OSK by 
Bob Billson and Boisy Pitre. 

Recently, my budget permitted me to 
acquire a 17 inch monitor. Previously, I used 
1 4 inch VGA monitors. While the computers 
and 1 4 inch mon itors supported 1 024 x 768 
screens, I used the 800 x 600 mode most of 
the time when dealing with text - the fonts 
were too small in the 1 024 x 768 mode on a 
14 inch monitor for me use comfortably. 
With the change in monitor, I now use the 
1024 x 768 mode almost exclusively; the 
fonts are easily readable. I can have 4 full- 
sizcd (80x24) windows fully visible using 
the normal fonts in the 1 024 x 768 mode (G- 
Windows includes 3 sizes of fonts which arc 
user selectable when opening anew window. 



The sizes are small -5x10 pixels, normal 
- 6 x 13 pixels and large - 8 x 16 pixels.) 
Rarely is all the information I require in a 
single file nor could it be displayed on one 
80 x 24 windows if it were. Having four 
full sized windows viewable simulta- 
neously permits access to the information 
I require. Sure, I could (and did) flip win- 
dows but time is lost and the chance for 
errors increases. Or, I could use SQL to 
assemble the information but unless I need 
this information for many items, custom- 
ers, vendors, or whatever, it isn't worth the 
time to set-up and run SQL. 

None of the software I use regularly is 
designed for G-Windows. The programs are 
all designed to run with text terminals. The 
main ones are SCULPTOR QuickEd, Data- 
Dex, SC, MW'sK&R C Compiler and sepa- 
rately, their assembler and linker and Ultra C. 
Typically, I'll have separate windows run- 
ning several SCULPTOR programs; i.e., the 
SCULPTOR main menu, inventory, inven- 
tory history , purchase orders, customer file, 
vendor file and, before the end of the day, 
additional programs called from the SCULP- 
TOR menu. I have a separate customer list 
running under DataDex. The aboveprograms 
are starting from a shell script file which is 
executed when G-Windows is started. Other 
programs are started using the G-Windows 
'custom ' menu, point and click using the file 
recognizer (more on these later) or from the 
comm and line in a shell window. 

I mentioned that I use 2 database pro- 
grams; SCULPTOR and DataDex. Thesoft- 
ware I use for the business is written under 
SCULPTOR. SCULPTOR, however, like 
all relational databases, does not lend itself to 
variable length fields and records. DataDex 
was written to support free form records of 
variable size. The two work well together - 
especially under G-Windows. 

To give an example, when a customer calls 
in, I like to call up his file in SCULPTOR. 
Often this docs not provide a complete 
record of his interests, problems, etc. For 
this, I use DataDex. After I've called a 
customer's record up in SCULPTOR I can 
press Shift-F9 to get the customer's DataDex 
file. If it exists, the record is displayed and 
I can review and/or add to it. If it docsn ' t, the 



file is displayed and I can easily add a new 
customer record to it. If the customer 
doesn't exist in the SCULPTOR file, an 
error will be returned and I can immedi- 
ately switch to the DataDex customer file 
and enter customer data. 

I can do everything I've described from 
a non-G- Windows display but I can't view 
files simultaneously, I could export data 
from the DataDex file to an ASCII file (or 
pipe) to be imported to the SCULPTOR 
customer list. This requires that information 
be input in a prescribed sequence. I find it 
best to input the information from the cus- 
tomer as hegives it to me and it may (and will) 
be in any order. Using the *copy and paste' 
capabilities of G-Windows I can transfer the 
appropriate information to the SCULPTOR 
customer file. I can do similar things with 
parts pricing and other information that I 
obtain over the phone. If the inform ation is 
already in electronic form, using *copy and 
paste' I can copy information from any file 
to any file I wish. There is no need to re-enter 
the data manually. 

I can't say programming under G-Win- 
dows suddenly becomes a joy but it is much 
less tedious than using a simple terminal 
particularly when a high resolution display 
is used. The editor can be run in one window. 
Header files, defines, declarations, other 
source code and other sections of the same 
source code can be displayed in other win- 
dows. If the windows are full sized,refercnce 
to and use of their contents makes the pro- 
cess of writing programs easier and me less 
prone to introducing errors. Andthedebug- 
ging process is made easier. I can have the 
editor running in one window. When I'm 



For comments or questions, Ed can be 
reached via this magazine or: 

E-mail: 

EDELMAR@delphi.com 
76576,33l2@CompuServe.com 

U.S. Mall: 
PO Box 78 

Middlctown, DE 19709 

Telephone: 

302-378-2555 Voice 
302-378-2556 FAX 
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finished with my changes, the file is saved. 
I can switch to another window and run 
lint, the makefile or the compiler or assem- 
bler. Errors can be quickly corrected and 
the process repeated. When I finally have 
a program I can run, it can be tested. Since 
I often obtain results not planned for (un- 
documented features) there is an edit, com- 
pile and test cycle to go through. G- Win- 
dows includes a history of the last 50 
commands. Using this capability can re- 
duce some of the tedium of this process. 
After making and saving the changes, I 
switch to a shell window and using the up- 
arrow key, select the last compile command 
with only a couple of key presses. When 
compiled, a couple key presses provide the 
command line last used to run the program. 

As can be seen, G-Windows introduces an 
environment or 'layer* between the operat- 
ing system and applications. The power of 
this environment becomes more apparent 
and useful as the capability of the display 
system is improved. The number of pro- 
cesses which may be run are not limited by 
G- Windows but by memory /operating sys- 
tem considerations. 

Until switching to a larger monitor and 
using it regularly, I didn't fully appreciate 
comparisons others had made with Sun 
workstations and other workstation of that 
class. Speed of performance of G- Windows 
(on a SYSTEM V) compared favorably. But, 
they said the feel wasn't quit the same. While 
these workstations can be obtained with 17" 
monitors, they're normally equipped with 
20" monitors and usually run with a resolu- 
tion of 1280x1 024 or better. Sinces witching 
to the larger monitor, two workstation users 
have worked with my SYSTEM V and have 
commented they felt completely comfort- 
able- that the differences between G- Win- 
do ws and X- Windows (on the Suns) they use 
were trivial. One did allow that he still 
prefers a 20" monitor. I should point out that 
both of these individuals are expert OS-9 
programmers and normally program for 
Motorola and Force VME systems. They 
use S un (S PARC) work stations (UNIX) and 
uscMW'sFASTTRACK forprogramming. 
In the next issue, I'll discuss SQjne of the 
industries where G-Windows is Dcing used. 
S N 

What do you mean you 
have a friend interested 
in the CoCo (or OS-9, or 
OSK!) and they don't 
have a subscription? 



Trek! 

Animated graphics in DECB 



Pete Blackwell 



Here's a neat little animated 
graphic routine. Look over the 
routine and see how Pete manages 
to make the "starship" move across 
the background. Once you figure 
that out, try to find a way to make 
the starship pass in front of the last 
two planets instead of behind them! 



2 ' Pete Blackwell 

4 *1408 1/2 McFadden St. 

5 'Paris TN 38242 
6 '(901) 644-2635 
8 'Nov. 1994 

10 WIDTH40:POKE 65497,0 

20 ON BRK GOTO 360 

30 HBUFF 1,100: HBUFF 2,100; HBUFF 

3,100 

40 HSCREEN2 

50 PALETTE0,0:PALETTE1,3: PALE 

TTE2.63 

60 HDRAW"BM3,3C4FR6F2E1L8U4" 

70 HDRAWBM0.1C5FR7F3E2L9U5" 

80HGET(0,0)-(15,7),1:HLINE(0,0)- 

(15,7),PRESET,BF 

90 FORS=1TO20:HSET(RND(320), 

RND(191), RND(8)):NEXTS 

100 HDRAW"BM1 30,30 ;S2C7D2L3D2L2D 

3R2D2L2D2L1D1H3D2H1L2U1L1U2H2U1 

L2H2L2H2L2H2D2L2D2L2H2L2D2L2U3H 

2U3H1 U2H1 U1 H1 R2E3ER3H3R3U3R3H3 

R2H2R3D2R2D2R3G2R3G2R3D2R2U3R3 

U2R2U3R2U3R3U2R3U2R3G2R3G2R3G3 

R2G3R3G3R2G3R3F3R3R2R2F3R2F2R1 

F3D2H2D3H2D3 H2L2D2L2H2D2L2H2" 

120 HDRAW"BM130,30;S3C7D2L3D2L2D 

3R2D2L2D2L1D1H3D2 H1L2U1L1U2H2U1 

L2H2L2H2L2H2D2L2D2L2H2L2D2L2U3H2 

U3H1U2H1U1H1R2E3ER3H3R3U3R3H3R2 

H2R3D2R2D2R3G2R3G2R3D2R2U3R3U2R 

2U3R2U3R3U2R3U2R3G2R3G2R3G3R2G 

3R3G3R2G3R3F3R3F2R3F3R2F2R1F3D2H 

2D3 H2D3H 2L2D2L2H2D2L2H2" 

140 HDRAW"BM130,30;S5C7D2L3D2L2D 

3R2D2L2D2L1D1H3D2H1L2U1L1U2H2U1 

L2H2L2H2L2H2D2L2D2L2H2 L2D2L2U3H2 

U3H1U2H1U1H1R2E3ER3H3R3U3R3H3R 

2H2R3D2R2D2R3G2R3G2R3D2R2U3R3U 

2R2U3R2U3R3U2R3U2R3G2R3G2R3G3R 

2G3R3G3R2G3R3F3R3F2R3F3R2F2R1 F3 

D2H2D3H2 D3H2L2D2L2H2D2L2H2" 

145 HDRAW"BM130,30;S7C7D2L3D2L2D 

3R2D2L2D2L1D1H3D2H1L2U1L1U2H2U1 

L2H2L2H2L2H2D2L2D2L2H2L2D2L2U3H 

2U3H1U2H1U1H1R2E3ER3H3R3U3R3H3 

R2H2R3D2R2D2R3G2RG2R3D 2R2U3R 

3U2R2U3R2U3R3U2R3U2R3G2R3G2R3 

G3R2G3R3G3R2G3R3F3R3F2R3F3R2F2 

R1F3D2H2D3H2D3 H2L2D2L2H2D2L2H2" 

147 HPAINT(126,29),4,7: HPAINT(120,24), 



7,7: HPAINT(127,27),3,7: HPA!NT(1 10,25), 
1,7: HPAINT(88,25),3,7 

148 HPAINT(120,34),5,7:HPAINT(1 10,38) 
,7,7: HPAINT(134,26),9,7 

149 HDRAW"BM145,54;C7L2U2L1H2L1D2 
L2U1H2D1L1U1H1L2H2L1D2":HPAINT(143, 
50),3,7: HDRAW"BM95,15;C7D2R1D2 L2 
D1 R1D1R1D2F2D1L1D1": HPAINT(94,18), 
0,7 

150 HDRAWBM216,23;C6E3;BM216,23; 
F3;BM216,23;G3;BM216,23; H3; BM216.23; 
L3;BM216,23; R3; BM216, 23; U3; BM216, 
23; D3" : HCIRCLE (216, 23J.2.4 

151 HCIRCLE(t10,25),2,5:HDRAW"BM110, 
25; C5E1 ; BM1 1 0,25;F1 ; BM1 10,25; G1 ; BM 
110,25;Hr: HCIRCLE(115,15),2,7: HDRAW 
"BM 115, 15;C7E2;BM115, 15; F2; BM 115, 
15;G2;BM115, 15;H2;BM115, 15; 
L2R4;BM 1 15,15;U2D4" 

152 HDRAW"BM120,165;C4E2; BM 120, 
165;G2;B M120,165;F2;BM120,165;H2; BM 
12 0,165;U2; BM120, 165; D2; BM120, 165; 
L2;BM120,165;R2"; H CIRCLE(120,165),2,1 
160HCIRCLE(70 1 85),25,1:HPAINT(72 1 83), 

1,1 

170 HCIRCLE (71,85),24,7,1,.75,.22: HCIRC 

LE(69,85),24,7,1,.75,.22:HCIRCLE{70,85), 

24,7,1, .75, .23 

180 HCIRCLE(58,80),3,8,1: HPAINT (59,79) 

,8,8 

190HCIRCLE(160,96),30,1:HPAINT(160, 

96), 6,1 

200HCIRCLE(159,96),29,7,1,.75,.24:HCIRC 

LE(160,96),29,7,1,.75,.24:HCIRCLE(161, 

96),29,7,1,.75,.25 

210HCIRCLE(250,105),40,7:HPAINT(255, 

102),7,7 

220 HCIRCLE{251 ,105),38 ( 1 .1 ,.75,.22 

230 HDRAW"BM75,70;S4C8G4L6D2 R3D3 

F4D3H4H2L2H2L2F3G4D2L2D2L2H3D3R3 

D2L2D3R3D3R3D2R3D2R2D1 R4U4E4D3 

R2D2R3U4R2U3R2U2R2H5D3L2U3L1 U3 

R2U2R3U2E2H2L2H2 UH1" 

240 HPAINT(70,75),8,8 

250 HDRAW"BM157,70;C8G2L3G2L3G2 

D3R2D3F4D3H2L2H3L2F3D2L2D2L2H2 

D3R3D2L2D3R3D3L3D3R2U2R2U2R3E4 

R3E2R3E2U2R2F3R3U2R2U3L2U3L2U2E 

3L2U3L3U2H3L3H2" 

260 HPAINT(158,90),8,8 

270 FORS1 = 1TO200:HSET(RND (320), 

RND(191), RND(8)):NEXTS1 

280 FOR X=0 TO 320 STEP4 

290HGET(X,100)-(X+15,107),2 

300HPUT(X,100)-(X+15,107),1,OR 

310 'PLAY"V31L1T25501C 

320 FOR T=1 TO 20:NEXTT 

330 HPUT(X,100)-(X+15,107),2,PSET 

340 NEXTX 

350 GOTO280 

360 WIDTH 32 

< 268'm > 
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More Tips on Fixing Color Computers and Accessories; Convert DS69A to B 



With support from Tandy for the Color 
Computer long gone, you can't always 
take a dead CoCo or disk controller to 
Tandy Repair and expect to get it fixed 
anymore. The same is true for most if not 
all third party accessories. Thus, I'm 
going to devote this column to tips on 
how a competent hardware hacker can 
better go about repairing CoCo equip- 
ment I'll include experiences of mine 
and others on specifically what to look 
for to maximize the chance you can make 
a repair. I'm also going to include some 
preliminary information on modifying 
the Microworks DS69A video digitizer 
to turn it into a DS69B that works with the 
Color Computer 3. 

Fixing a Color Computer 3: 

When a CoCo 3 dies with just a blank 
green screen showing, one should first 
try a few of the easy things: Try remov- 
ing, then re-seating, the GIME chip. Care 
must be taken in doing this. Either use a 
proper, fancy, PLCC chip removal tool, 
or be VERY careful in the useof jeweler's 
screwdriverstoleverthechipup. Tryre- 
seating the 512K board, if the computer 
has one in it Often a 5 12K board jammed 
too far in or too loosely in is the source 
of the problem. 

Other easy-to-test causes of failure 
would involve a bad memory chip (re- 
place memory chips... that's not hard or 
expensive to do), or oxidized contacts on 
the edge connectors in the system. Clean 
all edge connectors in the entire system, 
Multipak and all cards plugged into it 
with a pencil eraser. Clean them on both 
sides. This means the cases will have to 
come apart. If all this fails, you have to 
get more serious. 

The single most common thing to 
cause any CoCo to die with ablank green 
screen visible is the fried 6809Ecpu chip. 
This, in turn, is often caused by wiggling 
a cartridge as one inserts or removes it 
from a Multipak plugged in to the CoCo 
with ihe Multipak power on (it matters 
not whether or not the CoCo's power is 
on at the time). What has happened here 
is that the + and - 12 volts lines get 
shorted to their adjacent *HALT and 
*NMI lines, sending a blast of nasty 



voltage right into the 68B09E chip. The 
fix consists of removing the6809E from 
the CoCo mother board, installing a 
socket where it used to be, and plugging 
in to that socket a new, good , 6809E chip. 
Chip removal is most easily accomplished 
"destructively": One cuts each of the 
40pinsofthechip,thenliftsoutthechip. 
Then one uses a needle-nosed pliers 
and a soldering iron to heat each pad and 
remove each remnant of the pins of the 
chip from its hole. Then one uses a 
solder sucker to clean out the pads, so 
one can install a socket. 

I'd guess that roughly 4 out of 5 
CoCo's that die or are acquired dead 
with a blank green scree can be fixed 
simply by replacing the cpu chip. It's 
most fortunate that it's quite rare for the 
(irreplaceable) GIME chip to get blown. 

If you have an extension keyboard, 
or are messing with the keyboard con- 
nector, it's possible to zap the keyboard 
PIA chip. I did this once or twice when 
I was developing my keyboard extender 
cable. I've been told that an ordinary 
68B21 PIA chip will substitute for the 
keyboard PIA chip. The Tandy key- 
board PIA actually has some capacitors 
built into it supposedly to help with 
keybounce. A standard PIA causes no 
noticeable increase in bounce, however. 
If your CoCo was working, then dies 
witha totally BLANK screen, listen care- 
fully when you turn the power to it on. IF 
you hear the distinctive DOUBLE click 
of the cassette relay at power up, you 
have a problem in the video circuitry. IF 
you hear no or a single click, one possi- 
bility is a broken main clock crystal. 
This is especially a possibility if you 
have DROPPED the Color Computer. 
Use an oscilloscope to check to see if 
the crystal is oscillating. If not, replace 
it with another 8X colorburst crystal. 

If you check all these things are still 
unable to fix the CoCo, you're into 
more serious repair. The next step usu- 
ally involves putting an oscilloscope on 
all the lines of chip after chip, looking at 
and comparing signals. For example, look 
at the address, data, *CAS, and *RAS 
signals going to each DRAM chip. In 
one case, after WEEKS spent by a very 



experienced repair tech (George Bethea 
of New York State) trying to fix a CoCo 
3 that had worked for three years then 
had suddenly died, this approach 
showed that there was NO *CAS signal 
going to the rear-most of the four 4 X 64K 
DRAMs in a dead 128K CoCo 3. Note 
that this was AFTER this fellow had 
non-destructively removed and tested 
the CPU, the ROM, the GIME, the PIA, 
and the memory chips in the machine. 
After he noticed the absence of the 
*C AS signal, he used a continuity tester 
to discover that the trace between the 
third and fourth DRAM chip carrying 
the *CAS line had corroded and disap- 
peared at a spot that was concealed 
UNDERNEATH thethirdDRAM socket, 
just where it left the pad of the third 
DRAM to become a trace going to the 
fourth DRAM. Presumably this had 
been a defective trace to begin with, and 
over the years had corroded and eroded 
further. Note that checking address and 
data and other control lines with an 
oscilloscope is helpful if you had a pre- 
viously working CoCo 3 that now is dead 
after you attempted to socketits 68B09E 
chip in order to replace it with a 63B09E. 
Note, too, that traces can leave pins both 
on top and on bottom of the circuit 
board, and so can tear during replace- 
ment operations on EITHER side. 

Exactly the OPPOSITE of this can 
happen too: I once had a CoCo I whose 
cassette port ceased to operate. Using 
a signal tracer (Radio S hack $ 1 speaker 
/amplifier box) it was discovered that the 
outgoing cassette signal just disap- 
peared... was shorted to ground... at one 
point in the circuit. Careful examination 
of the circuit board with a magnifying 
glass at that area showed a ROGUE 
TRACE that had literally GROWN be- 
tween a pad carrying that signal and a 
very near by ground area on the circuit 
board. This rogue trace was only a 
millimeterorsolong...butitwasenough 
to short out the cassette line. These are 
actual examples of rather odd, very hard 
to fix problems. But a determined techni- 
cian can often find them. It DOES take a 
lot of time, and a lot of more obvious 
things have to be checked for first. 
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Disk Controllers: 

The single most common cause of a 
dead disk controller is a blown 7406 (or 
7416) chip on the *NMI and *HALT 
lines. When this happens, the *HALT 
and/or *NMI lines are forced true at all 
times. This in turn causes the CoCo to 
power up with a blank green screen 
whenever you try to power it up with 
such a blown controller in place in the 
CoCo or in the Multipak that is con- 
nected to the CoCo. This failure is caused 
by the same event (wiggled cartridge in 
the Multipak) that blows cpu chips in the 
main CoCo. 

Socket the 7406 or 7416 chip, and 
replace it with a new 7406. 74 1 6's should 
be replaced with 7406's, for they are exact 
replacem ents f or the 74 1 6 and a bit more 
rugged (rated to higher voltages) ."Most, 
if not all, CoCo disk controllers have 
TWO 7406 (or 74 1 6) chips. Just find the 
one that is part of the *HALT and *NMI 
circuitry, and replace that one. 

Sometimes other small scale logic 
chips (74LS00, 74LS02, etc.) associated 
with the*HALTand*NMI circuitry also 
get blown. These may have to be re- 
placed, too. 

Rick Ulland has reported to me that 
he's seen disk controllers that had been 
dropped and suffered from a broken 16 
MHz crystal or TTL oscillator. This is 
easy to check for... just use an oscillo- 
scope on the clock circuitry when power 
is applied to the controller, looking for 
oscillations. If the clock is dead, replace 
the crystal or oscillator module (which- 
ever your particular controller happens 
to have) with an appropriate replace- 
ment part 

I recently found a disk controller that 
did not crash the computer when con- 
nected, but which refused to properly 
turn on the drive select lights. If I typed 
POKE&HFF40,1 thedriveO light did not 
come on. Similarly, if I typed POKE 
&HFF40.2 the drive 1 light did not come 
one. Yet, when I attempted a DIR com- 
mand, the head of the drive did try to 
seek tracks. I reasoned here that the 
register at $FF40 which controls drive 
selection was damaged. This register 
physically IS a 74LS273 chip on almost 
all models of disk controller (and wason 
the Tandy FD500 that was I was working 
on). When I replaced just that one chip 



(theLS273 chip) theproblem went away, 
and the controller started functioning. 

If you plug in the disk controller and 
power up and your CoCo comes up with 
EXTENDEDBASICPiskROMnotrec- 
ognized), you may have a blown Disk 
ROM. Replace it with a new one (it's 
good to keep spares) and see if this fixes 
theproblem. The controller that had the 
bad LS273 chip also had a blown Disk 
Basic ROM chip. 

HappiIy,it'srarefortheWD1773disk 
controller chip found in the later model 
Color Computer disk controllers to be 
blown. That chip is nearly impossible to 
get hold of these days, though Rick 
Ulland and SBUG should have a few. 

RS232 paks: 

Themostcommon problem with RS232 
paks is a blown level converter chip. 
This is typically the 1488 or 1489 chip. 
Sometimes the 655 1 UART is blown, but 
this is rare. The LS TTL chips in it virtu- 
ally NEVER get zapped. IF they are 
zapped, probably every other chip on 
the thing is zapped, too. Of course, 
some variant RS232 devices use the 
MAX 232 chip as a level converter. On 
those, you want to try replacing that 
chip. 

Testing the RS232 pak is facilitated 
by using a RS232 tester... a thingie with 
LEDs that show the status of each of the 
serial port lines. By booting and then 
trying to operate a term program while 
watching the lights, you can often get an 
idea of where to start looking for prob- 
lems. Note that a plain old external mo- 
dem can in apinch often serve as a RS232 
line checker, by using the lights ON the 
modem. 

The DS69A and DS69B: 

I recently was asked by Terry S immons 
if I could help him convert two DS69 A's 
intoDS69B's. These werevideodigitiz- 
ers made by Microworks. Microworks is 
no longer in the CoCo market, and told 
Terry they did not care to support that 
product. However, they did say that the 
main difference between the DS69A 
and DS69B was the programming of 
the 16L8 address-decoder PAL chip on 
the unit. 

Terry sent me a DS69B and two DS69 A 
units. I dcsoldcrcd the 16L8 PAL chips 



from all of them, socketed all of them, 
and burned new 1 6L8 PAL chips for the 
DS69A's based on the information I 
read out of the PAL chip on the DS69B . 
I also checked the 16R8 PAL chip on the 
digitizers, and found they were all the 
same. I further noted that the circuit 
boards for the DS69 A and DS69B were 
identical... both were labelled "DS69 A". 
The74HC14ontheDS69Ahadpin 1 sent 
to ground via a 220 pf NPO type disk 
capacitor, but the same pin of the same 
chip on the DS69B was sent to ground 
via 150 and 1 20 pf capacitors in parallel. 
So I added a 50 pf cap in parallel with the 
220 pf cap on the DS69 A at that spot. 

When I returned the modified 
DS69A's to Terry, he found one of them 
worked perfectly as a DS69B with the 
driver software for the DS69B. The 
other one, he told me, worked, but the 
image had some funny stripes on it. 
Terry later informed me that he saw 
some other small differences between 
the DS69A and DS69B right at the video 
input jack on the DS69A. Apparently 
some resistors and capacitors were dif- 
ferent, or added, or subtracted. Thus, if 
you are trying to do this same conver- 
sion, look carefully there and make 
whatever changes are needed. 

For those with PAL programmers, the 
fuse map for the 16L8 PAL chip of the 
DS69B digitizer, as read by my ancient 
device programmer in my lab, is on page 
18 of this issue. Note that there exists 
software to convert a 1 6L8 fusemap into 
one that can be burned into a 16V8 GAL 
chip. 16V8 GALs are cheaper and more 
easily available than the older technol- 
ogy 16L8 PAL chips. 

Readers may contact me if they wish 
to buy 16L8 PAL chips burned with 
DS69B addressing fuse map data. Price 
is S 1 2 per chip, shipping incl uded. Same 
is true for Tandy 26-3024 Multipak up- 
grade PAL chips, necessary for using 
the large gray or white Multipaks with 
the CoCo 3. < 268'm > 

Comments and questions may be sent 
in care of 68'Micros or directly to : 

Dr. Marty Goodman 

1 633 Bayo Vista Avenue 

San Pablo, C A 94806 

E-mail: martygoodman@dclphi.com 
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Operating System -Nine Russell Hoffman 

Permanently change drive options, frequently asked questions. 



Editor: Well, Rick is a bit busy this time, so we 
obtained some interesting information to keep 
readers informed until the next issue. 

Floppy Drive Step Rate 

The first tid-bit comes from a problem I was 
having. It seems that no matter how many times 
I used dmode to change my disk drive step rate, 
it refused to stay that way! I followed the 
instructions in the OS -9 manuals, and made sure 
I used cobbler to make the changes permanent, 
but they didn't change! It seems that cobbler 
won't save changes made to the disk drivers using 
dmode, but there IS- a way to easily make the 
changes permanent: 
LOAD MODPATCH 

at the prompt, type (dont't type comments)- 
L /DO (link to module /dO) 

C 14 00 03 (change byte 14 from 00 to 03) 
V (verify) 

Now use cobbler and the changes will be 
permanent! Repeat for all disk drives as needed 
simply by changing the/Dx. 03 changes them to 
a 6ms step rate. 

OS-9 FAQ 

This is the sixth edition (23 Apr 1993) of the 
OS-9 FAQ (Frequently Asked Questions). 
Addresses will be referenced by number (e .g . [ 1 ] ) 
and the address will be listed at the bottom of the 
file. S$ indicates a question I don't know the 
answer for. If there are any additions, corrections, 
suggestions, comments, flames, or contributions, 
please respond in kind to me, Russell Hoffman, 
rh2y+@ andrew.cmu.edu (editor: I will pass along 
any comments for those without Internet access). 

Q: What is OS-9? 

A: OS-9 is areal-time, multiuser, multitasking 
operating system developed by Microware 
Systems Corporation. It was originally developed 
for the 6809 microprocessor, in a joint effort 
between Microware and Motorola. The original 
Level 1 6809 OS-9 OS was capable of addressing 
64 kilobytes of memory. The Level U 6809 OS- 
9 took advantage of dynamic address translation 
hardware, and allowed a mapped address space 
of one megabyte on most systems, and up to two 
megabytes on others, most notably the Tandy 
Color Computer III. In the 1980's, Microware 
ported OS-9 to the 68000 family of 
microprocessors, creating OS -9/68000. Code is 
mostly portable from OS-9/6809 to OS-9/68000 
at the high -lev el -language source code level. Code 
is compatible within cither OS-9/6809 or OS-9/ 
68000 at the binary level. OS-9/68000 provides 
synchronization and mutual ex elusion primitives 
in the form of events, which arc similar to 
semaphores. It also allows communication 
between processes in the form of named and 



unnamed pipes, as well as shared memory 
in the form of data modules. OS-9 is 
modular, allowing new devices to be 
added to the system simply by writing 
new device drivers, or if a similar device 
already exists, by simply creating anew 
device descriptor. All i/o devices can be 
treated as files, which unifies the i/o 
system. In addition, the kernel and all 
user programs are ROMable.Thus, OS- 
9 can run on any 680x0 based hardware 
platform from simple diskless embedded 
control systems to large multiuser 
minicomputers. 

Q: What is OSK? 

A: OSK is an abbreviation for OS-9/ 
68000. This is probably due to the 
common abbreviation '68K* for the 
68000 microprocessor. Also sometimes 
called OS-9/68K. 

Q: Where can I get OS-9? 

A: Generally the hardware vendor will 
ship aversion of OS-9 with the product 
upon which OS-9 is intended to be run. 
Alternatively, OS-9 can be purchased 
from Microware [1] itself, for certain 
hardware platforms. In addition, several 
software vendors sell customized and 
enhanced OS-9 packages for certain 
models of computers (see "Nine Flavors 
of OS-9" in this issue). 

Q: What machines run OS-9? 

A: OS-9/6809 runs on a variety of 
platforms, perhaps the most (in)famous 
being the Tandy Color Computer. Other 
systems include the SWTPC SCB-69, 
the Gimix 6809, Smoke Signal 
Broadcasting's Chieftain 6809, FHL's 
TC-9, the Febe, and many others, most 
of which are SS-50 bus machines. Note 
that OS-9/6809 is no longer supported 
by Microware, but many user groups, 
BBSes, and a handful of FTP sites offer 
help and maintain software collections 
for OS-9/6809. OS-9/68000 runs on quite 
a multitude of machines, including a 
variety of systems from Hazel wood 
(such as the UniQuad I and II), the Gimix 
Micro-20, the Atari ST, Commodore 
Amiga, Apple Macintosh, IMS MM/1, 
FH LTC-70, and a large number of 680x0- 
based VME systems, manufactured by 
such companies as , Motorola, Hcurikon, 
Inducom [12], Gimix [17], Force, Mizar, 
PEP Modular Computers [14], and 
others. Gcspac [ 1 0] also makes machines 
based on their G-64 and G-96 bus. 



Q: Where do I get OS-9/68000 for the 
Macintosh, Commodore Amiga, and the 
Atari ST? 

A: See "Nine Flavors of OS-9", Vol. 2 
No. 3 of "the world of 68' micros" 

Q:WhatisOS-9000? 

A: OS-9000 is a portable version of OS-9, 
written primarily in C. It can potentially run 
on any 68020 or higher 680x0 family member, 
and any 80386sx or higher 80x86 member. 
Code is portable across OS-9000 platforms 
at the source level. Theoretically, OS-9000 
can be ported to any modern computer 
architecture, though 680x0 and 80x86 are the 
only supported microprocessor families at 
present. 

Q: What software is available for OS-9? 

A: Nearly any user application can be 
found either commercially or in the public 
domain/shareware/freeware. Many word- 
processor, spreadsheets, databases, and time 
management software packages are available 
from a variety of vendors. A list of much of 
the availablecommercial software is available 
from Microware. They publish the "OS-9 
Sourcebook", a listing of hardware and 
software vendors who sell both 6809 and 
68000 software and hardware. It is advisable 
to contact the individual companies listed in 
the Sourcebook and request a recent catalog, 
as the information in the Sourcebook is a tad 
outdated. Microware's quarterly magazine 
Pipelines also carries new product 
announcements. 

Q: Where can I get public-domain/ 
shareware/freeware software for OS-9? 

A: There are many private bulletin boards 
around. In addition, there is the Princeton 
Listserver, which acts as a mailing server that 
will mail requested software. To begin using 
the Listserver, send electronic mail to 
LISTSERV® PUCC.PRINCETON.EDU, 
with the single line HELP in your message. 
Also, the OS-9 User's Group [7] maintains 
a library of public domain sofwtare, as well 
as distributes a newsletter. Finally, there are 
a few anonymous FTP servers worldwide 
with OS-9 software on them: 

cabrales.cs.wisc.edu — Contains mostly 
OS-9/68000 software, including the complete 
TOP package, many EFFO disks, GCC and 
G++, (and many other GNU products such 
as flex and bison), ka9q, k5jb, TcX, LaTcX, 
and quite a bit of 6809 software. 
wuarchive.wustl.edued — Has mostly 6809 
OS-9 software 
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lucy.ifi.unibas.chMah.rc — Meant to be a 
European duplicate of cabrales. 

Don't forget the often overlooked 
mails erver on cabrales. The e-mail address is 
OS-9archive@cabrales.cs. wisc.edu, and a 
message with "help" as the body will return 
some help text. This provides some access 
through mail for those without FTP. 

Q: What is the TOP package? 

A: TOP is an acronym for 4 The OS-9 
Project". It is a collection of OS-9/68000 
software developed primarily in Germany. 
Much of it seems to be an attempt to make 
OS-9 a little more UNIX-like. Many standard 
unix utilities are provided, as well as a complete 
UUCP mail implementation, and a more 
secure password file and login program. Many 
traditional unix games are also provided. The 
total package consumes approximately 16 
MB of disk space, though much of this is 
source code. 

Q: Who/what is the EFFO? 

A: EFFO, The European Forum For OS- 
9, maintains alarge library of PD Software for 
0S-9,e.g. the new C-Kermit 5A(188), an 
improved KA9Q Software called SLIP for 
OSK, Ghostscript and many other fine 
products. The software is available at a 
nominal handling fee, including written 
instruction or even a complete users manual. 
$$ Need EFFO address $$ 

Q: Are there any independent magazines 
covering OS -9? 

A: There is the "OS-9 Underground 
Magazinc"[15J, "OS-9 International"! 13], 
and "the world of 68' micros"[16]. OS-9 
Underground and 68' micros is in English, 
OS-9 International is 50% English, 50% 
German. 

Q: Are there alternative shells for OS-9? 

A: Yes, there are. Microware sells mshell, 
an enhanced shell. There are also several 
public domain shells available. The most 
notable is the Bourne shell, sh, available in the 
TOP package (OS-9/68000). It supports 
aliasing, command-line editing, history, 
environment variable replacement, shell 
scripting, the 'command* operator (uses 
output of command as arguments to called 
program), and a startup file. A PD version of 
ksh is available on cabrales. For OS -9/6809, 
there is Shell-*- and of course if you have a 
Color Computer, there is always Gshell, a 
graphical shell. 

Q: Can one read/write MS-DOS format 
disks under OS-9? 

A: There arc several public-domain and 
commercial utilities to accomplish this task 
for both OS-9/6809 and OSK. One of the 



more interesting is the MSFM file manager 
which appears in _OS-9_Insights_, a book 
by Peter Dibble, available through 
Microware. MSFM is an actual file manager, 
which allows you to mount an MS-DOS 
floppy as part of the OS-9 file system. For 
the CoCo, there is a set of utilities called 
RSDOS and PCDOS that read/writes CoCo 
(DECB) and MS-DOS disks from OS-9, 
respectively. They do not format disks 
though. These are available on the Patch OS- 
9 disk set from FARNA Systems [16] or on 
several BB Ses. 

Q: What sorts of communications software 
is available? 

A: Many public domain utilities, available 
from your local BBS, include terminal 
emulators and file transfer utilities (such as 
xmodem, ymodem, zmodem, and kermit 
protocols.) Sterm, anon-commercial package, 
also supports CompuServe B+ protocol. 
Many software vendors sell various 
equivalent packages. C-kermit is available in 
source and executable form for OS-9/68000 
on cabrales. Microware sells the NFM 
Network File Manager, which is a local- area 
networking protocol for small networks of 
strictly OS-9 based computers. NFM runs 
on virtually any network interface (direct 
serial links, ARCnet, Ethernet, and others). 

Microware also sells ISP, or Internet 
Support Package, which is a relatively 
complete TCP/IP package, including telnet 
client and server applications, and FTP client 
and server. It also provides a C BSD 4.2 
compatible socket library. Closely related is 
ESP, or Ethernet Support Package. This is 
similar to ISP, but is for particular Ethernet 
boards. Current word from Microware says 
that the ESP is now obsolete, and has been 
replaced by apreconfigured version of ISP. 
ISP supports Ethernet and SLIP, although 
there is no current SLIP driver supported by 
Microware. Microware also sells NFS, or 
Network File System, for OS -9/68000. This 
allows an OS-9 system to share files in a 
heterogeneous environment (i.e. not all the 
machines on the network run OS-9). NFS 
requires ISP or ESP. Finally, there is a port 
of the Phil Karn ka9q internet software 
package, which supports a single-user 
interface to TCP/IP. It includes a telnet 
client, an FTP client and server, and SMTP. 
Source and cxccutablcs may be found on 
cabrales. Note that the cxccutablcs on cabrales 
have a bug in the FTP server. The k5jb code 
should correct this. 

Q: What about uscnet and news? 

A: Several ports of UUCP software arc 
availablcforbothOS-9/6809andOS-9/68K:. 
A port of C news and Rn are available on 
cabrales. TOP has ported Notes, which 



maintains Notes files. There is a program 
which will transfer between Notesfiles and 
netnews. The TOP package in its entirety 
may be found on cabrales. Rick Adams' 
UUCP port for the Color Computer may be 
found on wu archive, as well as on Delphi 
and CompuServe. 

$$ Need info on the latest ELM port $$ 

Q: Is gec available for OS-9? 

A: gec and g++ are available for OS-9/ 
68000, both in OS-9 executable form and 
cross -compiler form. Versions 1 .37, 1 .39 and 
1.40 were ported to OS-9/68000 primarily 
via the work of Stephan Paschedag. Source 
and binaries are available on 
cabralesxs.wisc.edu via anonymous FTP. 
The 1.40 version supports 68040 
optimizations. 

Q: Can I run XI Ion OS-9? 

A: Yes. Microware [1] sells a port of 
XI 1R4 (client and server plus optional Motif), 
as well as do Eltek Electronik GmbH [8] 

$$ Need info on Keith Thompson's 
XllR5port$$ 

Q: What other graphics alternatives are 
there? 

A: Several other organizations have various 
graphics packages for OS-9. Reccoware 
Systems [9] has a port of the Bellcore MGR 
window manager. Gespac [10] produces G- 
windows, a portable windowing package 
which has device windows and a very Motif- 
looking interface. For the MM/1 , BlackHawk 
Inc. [ 1 1 ] is producing K-windows, a window 
manager similar to Multi-Vue, the OS-9 
window package for the Tandy Color 
Computer m. Microware [ 1 ] also sells RAVE, 
the Real-Time Audio Video Environment. 

Q: What is a Real Time system? 

A: A real-time system is any system 
whose correctness depends not only on the 
correctness of the applied algorithms, but 
also in the timing of the execution of those 
algorithms. Refer to the netnews 
comp. realtime newsgroup for more 
information, 

Q: Are there analytical frameworks for 
reasoning about timing correctness of real- 
time applications written under OS-9, ala 
Lchocsky, Sha, and Ding analysis? 

A: PLEASE! Somebody find out! 
Otherwise, Til be forced to make an OS-9 
operating system model myself... 

Q: Docs OS-9 support multiple threads 
within a program? 

A: Not directly, but through the use of user 
installed periodic interrupts or alarms, a 
program can support it's own threads. 
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FAQ Addresses, by reference number: 



S _ 

Microware Systems Corporation 
1900 N.W.I 14th Street 
Des Moines, Iowa 50322 
Phone: (515) 224-1929 
Fax: +1(515) 224-1352 

Microware Systems Corporation 
Western Regional Office 
2041 Mission College Boulevard 
Santa Clara, California 95054 
Phone: +1 (408) 980-0201 
Fax: +1(408)980-1671 

Northeastern Regional Office 

One Crank Rd 

Hampton Falls, NH 03844 

(603)9294107 

(603)929-4233 fax 

Southeastern Regional Office 

P.O. Box 510358 

Melbourne Beach, FL 32951-0358 

(407)725-2840 
(407)725-2487 fax 

Microware Systems (UK) Limited 
Leylands Farm, Nobs Crook 
Colden Common 
Winchester, Hants. 
England, S021 1TH 
Phone: +44 703 601990 
Fax: +44 703 601991 

Microware Systems K.K. 
17-3, Sotokanda 2-Chome 
Chiyoda-Ku 
Tokyo 101, Japan 
Phone:+813-3257-9000 
Fax: +813-3257-9200 

Microware Systems France 

Chateau de la Saurine 

PontdeBayeux 

13590 Meyreuil 

France 

Phone: +33 42 58 63 00 

Fax: +33 42 58 62 28 



B- 



OS-9 User's Group, Inc. 
6158 W. 63d St.. Suite 109 
Chicago, IL 60638 

B 



Eltck Elcctronik GmbH 

Galilco-Galilci-Strasse 1 1 

D-6500 Mainz 42 

Germany 

Phone: (6131) 588-0 

fax:(6131)588-199 



Reccoware Systems 
Wolfgang Ocker 
Lochhauser Strasse 35a 
D-8039 Puchheim 
Voice: +49 89 80 77 02 
Fax: +49 89 8029 67 



n- 



To contact Gespac, call toll-free 
1-800-4GESPAC 



HI- 



BlackHawk Enterprises, Inc. 
P.O. Box 10552 
Enid, OK 73706-0552 
Voice: 405-234-2347 
E-mail: nimit2@delphi.com 



n- 



Inducom Systems BV 
PO Box 627 
NL5340AP OSS 
Phone (31)4120-41922 
Fax (31)4120-22640 



BI- 



OS -9 International 
Hagentalerstrasse 12 
CH^055 Basel, Switzerland 
Tel. +41 6143 55 01 
Fax +41 6143 55 02 
E-mail OS-9int@msys.ch 



M- 



PEP Modular Computers 
USA 

Pep Modular Computers, Inc. 
750 Holiday Drive, Building 9 
Pittsburgh, PA 15220 
Tel++1 (0)412 921-3322 
Fax ++1(0)412 921-3356 
Toll Free 800-228-1737 

Great Britain 

PEP Modular Computers Ltd. 
Unit 3, Riverside Business Centre 
Brighton Road 
Shoreham-By-Sea 
West Sussex, BN43 6RE 
Tel ++44 (0) 274 44 11 88 
Fax ++44 (0) 273 44 1 1 99 



Benelux . 

PEP Modular Computers S.A. 
Koning Albert l-laan46 
B-1780WEMMEL 
Tel ++32 (0) 24 61 04 08 
Fax ++32 (0)24 61 00 31 

Germany 

PEP Modular Computers GmbH 
Apfeltranger StraBe 16 
D-8950 KAUFBEUREN 
Tel ++49 (0) 83 41 43 02 - 
Fax ++49 (0) 83 41 43 02 - 39 



OS-9 Underground 
4650 Cahuenga Blvd. Ste7 
Toluca Lake, CA 91602 
Voice: 818-761-4135 



H 
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FARNA Systems 

Box 321 

Warner Robins, GA 31099-0321 

Voice: 912-328-7859 

E-mail: dsrtfox@delphi.com 



B- 



GMX (Gimix) 
3223 Arnold Lane 
Northbrook, IL 60062 
Voice: 708-559-0909 
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Comments and questions may be 

sent in care of68'micros or 

directly to the author at: 

RickUlland 

449 South 90th 

West Allis,WI 53214 

E-mailisrickuland@delphi.com 

Comments, additions, etc., for the 
OS-9 FAQ should be sent to: 

rh2y+@ andrew.cmu.edu 
(Russell Hoffman) 

Those without Internet access may 

send FAQ comments to 68' micros. 

We will forward the messages for you. 
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OS-9IOSK Answers! 

Tackling TERMCAP 



Joel Mathew Hegberg 



One of the most useful concepts used 
under OS -9 is "term cap", which is short for 
terminal capabilities. Within this standard, 
all the terminal-specific control sequences 
and special-key strings are kept within a/dd/ 
S YS/tcrmcap file. This alio ws your software 
to run on any terminal, whether it's VT-100, 
ANSI, K-Windows, ADM3A, Hazeltine, 
ABM85, TV1920... well, you get the idea. 
There are so many "standards" for terminals 
that it is obviously a tremendous benefit to 
be able to obtain this information easily at 
run-time for the type of terminal the user is 
on. 

As it turns out, this concept is also one of 
the most difficult to implement! Those of 
you who have tried to use termcap know 
what I mean. For those who Ve only glanced 
at it, this may come as a surprise. After all, 
the OS-9 C compiler comes with an entire 
library (termlib.l) dedicated to helping C 
programmers implement termcap within 
their software. The problem is the library 
doesn't handle the tough stuff. Many com- , 
plexities are left for the programmer to handle, 
and the documentation for the termcap li- 
brary is scarce, severely lacking in detail, and 
even self-contradictory in some parts. What 
I hope to do in the next couple issues is fully 
explain termcap to the fullest and give every- 
one the tools and knowledge to use termcap 
in their software. 

Due to space considerations, I'm only 
going to present the source -code for an ex- 
ample program in this issue. I could have 
done it the other way around (explained what 
I want to do and then give the source in the 
next issue), but I know how programmers 
prefer to get experimenting with actual source 
code! The program is fairly large for what it 
docs, which shows just how complex it is to 
implement in even just a simple manner. 

Theprogram, 'termcaptest.c* (listing #2), 
merely clears the screen for the user and lets 
him/her type anywhere on the screen. The 
arrow keys may be used to move the cursor 
around the screen, and the backspace string 
is also supported. 

When you want to quit the program, press 
your keyboard interrupt key (usually con- 
trol C or control E) and the program will clear 
the screen and exit back to OS-9. 

This program requires the following ter- 
minal capabilities to be defined with in the 
termcap file: up, cl, cm, ku, kd, kl, kr, kb. If 
any of these arc missing, you will receive an 
"incomplete termcap entry*' message. For 
more information on editing your termcap 
file and what to put inside it, read pages 8-3 1 
through 8-37 in your "Using Professional 



OS-9" manual. I've included my termcap 
entry for my K-Windows system (vsc) as 
listing #1. 

Next issue, I'll fully explain how the pro- 
gram works and give some insight on what the 
library functions within termlib.l actually do. 
You will then be well on your way to under- 
standing termcap and employing this powerful 
standard with in your own software! 

Listing #1: example termcap entry 

kl IvsclSignetics Vsc Video driver by RMC:\ 
:am:bs:cl= A L:U#26:co#80:ho= A A:\ 
:cd^ A K:ce= A D:cm= A B%r%+ %+ :pt:\ 
:do= A J:up=NE[A:nd= A F:so=V)37 
:se=NX)37!:\ 

:us=V)37 M :ue=V)37#:al=\0370:dl=V)371 :\ 
:ku= A P:kd= A N:kr= A F:kl= A B:kb= A H:sf=V)12:\ 
:ve=\D05!:vi^\005 :bl=\007: 

Listing #2: termcaptesLc 

#include <stdio.h> 
include <sgstat.h> 
#include <termcap.h> 

#define TCAPSLEN 400 

#denne BUFFSIZE 20 

#define STDIN 

#define STDOUT 1 

/* user-defined values for special keys */ 
/* values are not important, but must */ 
/* be greater than 255. ENTER is just */ 
/* the value 13 for CR. */ 

#define UP_ ARROW 400 

#define DOWN_ARROW 401 

#defme LEFT^ARROW 402 

#define RIGHT_ARROW 403 

#define BACKSPACE 404 

#define ENTER OxOD 

extern char *getenv(); 

int user_tputc(), user_touts(X putpadQ, sigtrap(); 

/* variables for termcap stuff */ 
char tcapbuflTCAPSLEN]; 
short lines.columns.ospeed; 
char PC_, 

*UP, /* required by tgotoO */ 

*BC, /* required by tgoto() */ 

*CL, 

♦CM, 

*KU, 

*KD, 

*KL, 

*KR, 

♦KB; 

/* variables for my program */ 

int kcybuflcn,kcybufpos,kcyflag=0, donc=0; 
char kcybuff[BUFTSIZEJ; 
struct sgbuf sgbuffer.oldbuffer, 



main() 

( 

int keypress, 

cx=0,cy=0; /* initial cursor position */ 
char keychar, 

/* program initialization */ 
initialize_termcapO; 
intercept(sigtrap); 
getsta^O.STDIN.&sgbuffer); 
_strass(&oldbuffer,&sgbuffer32); 
sgbuf fer . sg_pause=0; 
sgbu ffer . sg_echo=0 ; 
sgbu f fer.sg_eofch= *V)'; 
setstat(0,STDIN.&sgbuffer); 

/* clear screen & position cursor */ 
putpad(CL); 
putpad(tgoto(CM,cx,cy)); 

while(!done) 

{ 

if (keyflag=-l) /* old keys waiting */ 

keypress=process_keyO; 
else 

i 

/* get a key & process it */ 
read(STDIN,&keychar,l); 
keypress =process key (key char); 

} 



if (keypress) 

i 

switch(keypress) 

{ 

case UP^ARROW: 

if (— cy<0) cy=0; 

break; 
case DOWN.ARROW: 

if (++cy>=lines) cy=lines-l; 

break; 
case LEFT_ARROW: 

if (— cx<0) cx=0; 

break; 
case RIGIIT.ARROW: 
if (++cx>=columns) cx=eolumns-l; 

break; 
case BACKSPACE: 

if (•— cx<0) cx=0; 
putpad(tgoto(CM,cx,cy)); 

tputc(* '); 

break; 
case ENTER: 

cx=0; 

if (++cy>=lincs) cy-lines-1; 

break; 
default: 
/* make sure character is printable*/ 

if (kcyprcss>=0x20 && 
kcyprcss<=0x7c) 

{ 

/* put it on the screen */ 
tputc((char) keypress); 
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if (+-f-cx>=columns) else 

( ( 

cx=0; retkey=t; 

if (++cy>=lincs) cy=lines-l; keyflag=0; 

} ) 

i } 

break; break; 

} } 

/* make sure cursor is where it should be*/ return(rctkey); 

putpad(tgoto(CM,cx,cy)); } 



KB=tgetstr("kb",&ptr); 
UP=tgetstr("up",&ptr); 
lines=tgetnum("li"); 
columns=tgetnum("co"); 
ospeed=-l; /* no padding */ 

if (lines<l II columns<l) 

{ 

fprintf(stderr,"No rows or columns !\n"); 
exit(l); 



} 



/* cleanup before exit, clear screen */ 

putpad(CL); 

/* home cursor position */ 

putpad(tgoto(CM,0,0)); 
/* reset stdin characteristics */ 

setstat(0,STDIN,&oldbuffer); 



} 



/* process_key is given character to be */ 
/* processed. The processed character */ 
/* (of type int) is returned or zero (0) */ 
/* if key was swallowed. */ 

/*keyflag may have the following values:*/ 
/* -1 = old keys removed from buffer. */ 
/* = no keys are in buffer. */ 

/* 1 = keys being swallowed into buffer.*/ 
int process_key(key) 
char key; 

{ 

int retkey.t; 

switch (keyflag) 



( 



case -1: 

/* remove next key from buffer */ 
retkey=(int)ke ybuf f[key bu fpos++] ; 
if (!(— keybuflen)) keyflag=0; 
break; 
case 0; 

keybuff[0]=key; 
keybufpos=l; 
keybuflen=l; 
t=compare_specialO; 
if (!t) retkey=(int)key; 



/* compare_special checks to see if the */ 
/♦string within the buffer matches, partially*/ 
/* matches, or does not match any of the */ 
/* special-keys supported by termcap. The */ 
/* return value will be: 0= no match at all. */ 
/* 1= partial match, swallow more chars.*/ 
1*1 — user-defined value of special key. */ 
int compare_specialO 
{ 
int t=0; 

keybuff[key bufpos] = \)'; 

/* check for exact match */ 

if (!strcmp(keybuff,KU)) t=UP_ ARROW; 

if (!strcmp(keybufr,KD)) t=DOWN_ARROW; 
if (!strcmp(keybuff,KL)) t=LEFT_ARROW; 
if (!strcmp(keybuiT,KR)) t=RIGHT_ARROW; 
if (!strcmp(keybuff,KB)) t=BACKSPACE; 
if (t) retum(t); 



/* check for partial match */ 
if (!strncmp(keybuff,KU,keybuflen)) t=l 
if (!strncmp(keybuff,KD,keybuflen)) t=l 
if (!strncmp(keybuff,KL,keybuflen)) t=l: 
if (!strncmp(keybufT,KR,keybuflen)) t=l: 
if (!stmcmp(keybuff,KB,keybuilen)) t=l 
ret urn (t); 



initialize term cap 

{ 

char tcbuf[1024],*term_type,*temp,*ptr; 

if ((term_type=getenv("TERM ,, ))==NULL) 
{ 



/* make sure we have everything */ 
if (!(CL && CM && KU && KD && KL 
&& KR && KB && UP)) 

fprintf(stderr, "Incomplete termcap 
entryAn"); 
exit(l); 

) 

if (ptr>=&tcapbuflTCAPSLEN]) 

( 

fprintf(stderr,'Tenninal description too 
big!\n"); 
exit(l); 

} 



/* writes one character to terminal. */ 
/* needed by tputsO library function. */ 
int user_tputc(c) 
char c; 

{ 

return (write(STDOUT,&c,l)); 



/* writes an entire string to terminal. */ 

user_touts(s) 

char *s; 

{ 
write(STDOUT,s,strlen(s)); 



/* writes out a special sequence */ 
/* to the terminal. */ 

putpad(s) 



else 


fprintf(stderr, "Environment variable TERM 


char *s; 


t 


not definedAn"); 




( 


if (i=D 

r 


exit(l); 




tputs(s,l ,user_tputc); 


I 
retkey=0; 

keyflag=l; 

) 

else retkcy=t; 

} 
break; 


) 
if (tgetent(tcbuf,term type)<=0) 

( 

fprintf(stderr, "Unknown terminal 
* %& \\n",term_type); 
cxit(l); 


type 


i 

f* when a signal is received, we're done! */ 

sigtrap(signal) 

nt signal; 

( 

donc=l; 


case 1: 


) 




} 


keybuff[keybufpos+4-]=key; 

keybuflen ++; 


/* read the termcap entry */ 
ptr=tcapbuf; 

if (temp=tgctstr("PC\&ptr)) PC_= 

CL=tgctstr("cl",&ptr); 

CM=tgctstr("cm" t &ptr); 

KU-tgctstr( M ku",&ptr); 
KD=tgctstr("kd , ',&ptr); 
KL=tgctstr("kl M ,&plr); 
KR=tgetstr("kr" ( &ptr); 


i 
=*tcmp; 


t* TIE END */ < 268'm > 


t=comparc spccialO; 

if(!0 

( 

keyflag =-1; 

rclkcy=kcybufpos=0; 

j 

else 

( 
if (t==l)retkcy=0; 


Any comments, questions, or source 
code to be Included In Joel's column 
may be sent In care of 68*Mlcros or 
directly to Joel at: 

Joel Mathcw Hegbcrg 

936 N. 12th Street 

Dekalb, IL 60115 

E-mail : Joelhcgbcrg^dclphi.com 
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Hardware Hacker - continued from page 12 



•FusemapfortheDS69B 16R8PALchip: 
MODEL :XELTEKUNIPRO 
TITLE : C:\XCEL\DS69BR8JED 

DDTffiPAL16R8-25* 

DMTI* 

QP20* 

QF2W8* 

QVO* 

FO* 

L0000011111111111111111111111111111011* 

L0003211101111111111111111111110111111* 

L0006411101111111111111111101111111111* 

1X009611101111111110111111111111111111* 

L0012811101111111111111111111111111110* 

1X016011101111111111111111111111101111* 

1X019211101111111111111111111011111111* 

L0022411101111111111111101111111111111* 

1X025611111111111111111111111111111011* 

L0028811101111111111111111111111111111* 

1XO32011111010111111111111111111111111* 

1X03520(XXXXXXX)00000000(X)0000000000000* 

lXO38400(X)00aXXXX)00000000(X)00000000(X)* 

lXO4160000(XXXXXXXXX)000000(X)0000000000* 

L00448(X)(XXXXXXXXX)00000000000000000000* 

IXO480O0000C)000O0(XX)000000000000000000* 

IXO51211111111111111111111111111111011* 

L0054411111111111011111111111110111111* 

1X057611111111111011111111101111111111* 

L0060811111111111010111111111111111111* 

1X064011111111111011111111111111111110* 

L0067211111111111011111111111111101111* 

1X070411111111111011111111111011111111* 

1XO73611111111111011111110111111111111* 

1X076811111111111111111111111111111011* 

1X080011111111111011111111111111111111* 

L0083211111011111111101111111111111111* 

lXO864000(XXX)000(XX)00(X)000000000000000* 

LOD8%00000000000000000000000000000000* 

IXX)928O00000O0000C)0O000O30O000C)0000000* 

lXO960000000(XXXX)00a)0000(XXXX)(X)000000* 

lXO992000(XXXXXXXX)0000(XX)00000(XX)00000* 

L01024111 111 11111 111111111111111111011* 

L01056111 111 11111 111011110111111111111* 

L01088 1 1 1 101 1 1 1 1 1 1 1 1 1 1 1 101 1 1 1 1 1 1 1 101 1 1* 

L0ii20iiiiioiiiimmiiioimimoiii* 

L01 1 52(XXX)00(X)00(XXXXXX)00(XXXX)00000000* 
L01 1 840000000(XXXXXXXX)0000000000000000* 
L01216(X)0(XXX)00()00000000000O000000000O* 
Ii)1248(X)00000(XXXX)000(X)0(XXX)0(XX)000000* 
1X1128011111111111111111011111111111011* 
L01312111 1111111111101 11111 11011111 111* 
L013441 1110111111 111111101110111 110111* 
L013761 11101 11111 11111 11101 11011 1101 11* 



10140811111011111111111111111011110111* 
I^1440(X)00000000000000000(XX)0000000000* 
1X)14720000000000000000(X)000(XXX)0000000* 
1X)1504(XXXX)0(XXXXXXXX)(XXXXX)00000000000* 
L0153611111111101111111111111111111011* 
L0156811111111111111011111111111101111* 
L0160011110111111111111101110111010111* 
L0163211110111111111111110111111100111* 
L0166411110111111111111111111011100111* 
L0169611111011111111111111111111100111* 
101728000000(X)0(XXXXX)0000000(X)00000000* 
W176000000000000000000000000000000000* 
L0179210111111111111111111111111111011* 
L0182411111111111111011111111111111110* 
LX>i85611110111111111111101110111010101* 
L0188811110111111111111110111111110110* 
L0192011110111111111111111111011110110* 
L0195211110111111111111111111111100110* 
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Hardware: 




MM/1 Serial Cards 


$35 


MM/1 Midi Cards 


$45 


68340 acelerators 


$325 


SCSI Tape drives 


call 


SCSI Hard drives 


call 


BGFX in stock! 


$45 


RAM prices 


call 


Floppy Drives 


call 


Coming Soon - Modems, CD-ROM 


Software: 




PixUtils 


$25 


DeskTop for MM/1 


$79 


Fontasee 


$35 


Paint for MM/1 


$79 


New Software on the way! 





Now available - < 

MM/1 Systems! 

(call for pricing) 



BlackHawk Enterprises, Inc. 



P.O. Box 10552 

Enid, OK 73706-0552 

Phone 405-234-2347 

Internet: nimitz@delphi.com 
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WILDCARD.BAS Charles R. Connolly 

Wildcard routine for last issue's SDISK512K program 



10* WILD.BAS 

20 ' Wildcard file marking program called 

30 ' by Disk Organizer "SDSK512K.BAS" . 

41 ' (c) Charles R. Connolly 1994 

50 CLSPCLEAR 1 

60 PALETTE CMP:ATTR 0,0 

70 CLEAR 3000,30000 

80 FILES 3,768 

90 DIM F$(68),E$(68),T$(68),A$(68),CE$(10) 

100 ' F$=File Name E$=File Extension T$= 

File Type A$=Ascii Flag. 

110DIMSG(68),NG(68),FSL(68),EC(68),OC 

(68),GC(7) 

1 20 ' SG=Start Granule NG=Number of Gran 

ules GC=Granules to Copy 

130 DIM HH$(64),HO(8),WS(8),AT(8) 

140 'HELP VAR'S HH$=Text HO=Offset WS 

^Window Size AT=Attribute 

150 QM=2:CO=0:'Query Mode.Scratch Disk, 

Program Disk & CO=Context 

160 SE=3 

170 POKE 30100,78:"N" DO NOT REDO 

THE FILE MANAGER STARTUP SCREEN 

180PD=PEEK(30101) 

190 NF=0:'Number of Files. 

200 MD=3:'Max Drive Number. 

210 IF PD-0 THEN OPEN T,#1,"MENU- 

EXT.DAT:0" 

220 IF PD=1 THEN OPEN T^VMENU- 

EXT.DAT:1" 

230 IF PD=2 THEN OPEN T,#1,"MENU- 

EXT.DAT:2" 

240 IF PD=3 THEN OPEN T,#1,"MENU- 

EXT.DAT:3" 

250 EN=1 

260 ' EXTENSION FILE LOOP 

270 :IF EN>9 THEN GOTO 320 

280 :IF EOF(1 )=-1 THEN GOTO 320 ELSE 

INPUT #1,YE$ 

290:SC$=MID$(YE$,1,1) 

300 :IF SC$=" THEN CE$(EN)=MID$(YE$, 

2,3):EN=EN+1:GOTO260 

310 :1F SC$=~" THEN GOTO 260 

320 'WEND 

330 ME=EN 

340 CLOSE #1 

350 PRINT 

360 PRINT -INSERT DATA DISK IN :";D 

370 PRINT " PRESS ANY KEY " 

380 AK$=INKEY$:IF AK$=~ THEN 380 

390 WIDTH 32 

400 PRINT:PRINT:PRINT "reading directory 

':PRINT 

410 'REPEAT 

420 :DSKI$ D,17,SE,SL$,SH$ 

430:SEC$=SL$+LEFT$(SH$,127) 

440 :FORX=0TO7 

450 ::Z=X*32:' Each Directory Entry is 32 Ch 

aracters Long. 

460 ::IF MID$(SEC$,Z+1,1) = CHR$(255) GO 

TO 510 

470::IFMID$(SEC$,Z+1,1)<>CHR$(0)THE 

N GOSUB 1060 

480:NEXTX 

490:SE=SE+1 

500 IF SE<12 GOTO 410;'UNTIL 



510NF=NF-1:F$(NF+1)=CHR$(255) 

520 FOR l= TO 68:OC(l)-32:NEXT 

530 FOR l=0 TO 68:EC(I)=0:NEXT 

540 ' FIND THE SIZE OF THE FILE IN GRA 

NULES 

550 DSKI$D,17,2,SL$,SH$ 

560FORX=0TONF 

570:G=1:GL=SG(X)+1 

580 :IF MID$(SL$,GL,1)>HEX$(191) THEN 

NG(X)=G:GOTO630 

590 ::G=G+1 :*While NOT last Granule In Th 

e File 

600::GL=ASC(MID$(SL$,GL,1))+1 

610 ::IF MID$(SL$,GL,1)>HEX$(191)THEN 

NG(X)=G:GOTO630 

620 :GOTO590 

630 NEXT 

640 ' WILD initalization 

650 OF=PEEK(30199):'See if "Y"es. 

660 IF OF<>89 THEN PRINT "ARRAY NO 

T READY":END 

670AD=PEEK(30198) 

680 IF ADoD THEN PRINT 1NCORECT 

DRIVE":END 

690 FOR 1=0 TO NF:OC(I)=PEEK(30200+I): 

NEXT 

700 'WILD main program loop. 

710 CLS:PRINT - WILD CARD BUILDER" 

;PRINT 

720 PRINT " code opperation" 

730 FOR l=0 TO MD 

740 :IF l<>D THEN PRINT USING - ## 

copy FROM DRIVE ## TO ##";I;D;I 

750 NEXT 

760 PRINT" K kill" 

770 PRINT " R rename" 

780 PRINT • U undo" 

790 PRINT:INPUT • OPPERATION CODE" 

;OP$ 

800 IF OP$="U" THEN OP$=" UNDO" 

810 *— REM ADD ERROR CHECKING !! 

820 CLSPRINT " OP = ";OP$ 

830 PRINT:PRINT "MARK aLL OR sELEC 

T (a/S) •; 

840 INPUT MT$ 

850 IF MT$="A" OR MT$="a" THEN GOS 

UB 1980:GOTO 1000:'MARK ALL 

860 'SELECTIVE MARK. 

870 GOSUB 2150 

880 PRINT ■ SELECT BY:" 

890 PRINT:PRINT " FILE nAME" 

900 PRINT" eXTENSION" 

910 PRINT" FILEtYPE" 

920 PRINT" qUIT" 

930 PRINT 

940 INPUT " CRITERIA ";CS$ 

950 GOSUB 2150 

960 IF CS$="N" OR CS$-"n" THEN GOS 

UB 1170 

970 IF CS$="E" OR CS$="e" THEN GOSU 

B1320 

980 IF CS$="T" OR CS$=T THEN GOSU 

B 1450 

990 IF CS$="Q" OR CS$="q" THEN 

GOTO 2030 

1000 'DONE ? 



1010 CLS:PRINT " MORE (y/N) " 

1020 INPUT MW$ 

1030 IF MW$="N" THEN GOTO 2030 

1040 GOTO 700 

1050 END 

1060 'SUB Get a Disk Directory Entry's Cont 

ents. 

1070 ::F$(NF)=MID$(SEC$ 1 Z+1,8):' The File 

Name is the first 8 Bytes of the Entry. 

1080 ::E$(NF)=MID$(SEC$,Z+9.3):' The File 

Extension is the next 3 Bytes. 

1090 ::IF MID$(SEC$,Z+12,1)=CHR$(0) THE 

N T$(NF)="0" ELSE IF MID$(SEC$, 2+12.1) 

= CHR$(1) THEN T$(NF)«T ELSE IF MID$ 

(SEC$,Z+12,1) = CHR$(2) THEN T$(NF)="2" 

ELSE T$(NF)="3" 

1100::IFMID$(SEC$ > Z+13,1)=CHR$(0)THE 

N A$(NF)="B"ELSE A$(NF)="A" 

1110 PRINT 

1120::SG(NF)=ASC(MID$(SEC$,Z+14,1)) 

1130::NF=NF+1 

1140 RETURN 

1150 END 

1160 CLS:GOTO 700 

1170 'MARK FILES BY NAME 

1180 PRINT " MARK FILES BY NAME": PR 

INT 

1190 PRINT" ? n n* *n":PRINT 

1200 INPUT ■ ";WN$ 

1210 IF WN$="?" THEN GOSUB 1670: 'HE 

LP 

1220 WF$=LEFT$(WN$,1):WE$= RIGHTS 

(WN$,1) 

1230 IF WF$="?" THEN GOSUB 1670: GO 

SUB2150:GOTO 1180 

1240 IF WF$="*" THEN GOSUB 1790: RET 

URN 

1250 IF WE$="*" THEN GOSUB 1890: RET 

URN 

1260 'EXACT MATCH 

1270FORSU0TONF 

1280:FS$=F$(SI) 

1290 :IF WN$=FS$ THEN OC(SI)=ASC(OP$) 

1300 NEXT 

1310 RETURN 

1320 'MARK FILES BY EXTENSION 

1330 CLS 

1340 FOR El=1 TO ME:PRINT EI;\"+CE$ 

(EI):NEXT 

1350 PRINT 0;"NONE OF THE ABOVE" :P 

RINT 

1360 INPUT WN$ 

1370CI=ASC(WN$)-48 

1380 IF WN$="0" THEN INPUT " EXTENS 

ION ";EX$ ELSE EX$=MID$(CE$(CI), 1,3) 

1390 PRINT " ..MATCHING EXTENSION" 

;EX$ 

1400FORSI=0TONF 

1410:ES$=E$(SI) 

1420:IFEX$-ES$THENOC(SI)=ASC(OP$) 

1430 NEXT 

1440 RETURN 

1450 'MARK FILES BY TYPE 

1460 PRINT "aSCIl OR bINARY OR n/A :" 

1470 WN$=INKEY$:IF WN$="" THEN GOT 

O1470 

1480 IF WN$="A" OR WN$="B" OR WN$ 

= B a" OR WN$="b" THEN GOTO1560 

1490 'TYPE ONLY 

continued on page 25 
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Programming in "C" 

The C preprocessor 



P.J. Ponzo 



BEGIN main() { 

DECLARE_AN_INTEGER x; int x; 

LET x=0; x=0; 

AS_LONG_AS ( x IS_LESS_THAN 5 ) DO while (x<5) { 

LET x INCREASE.BY 1; x+=l; 

PRINT_x; printf("%d",x); 

THEN_STOP } 

END } 

Wouldn't it be nice if we could write the Left-Hand program 
(above) and have it (magically) turn itself into the Right-Hand 
program? 

This would require the following definitions: 
define BEGIN to mean main() { 
define DECLARE_AN_INTEGER to mean int 
define LET to mean (nothing!) 
define AS_LONG_AS to mean while 
define IS_LESS_THAN to mean < 
define DO to mean { 
define INCREASE_BY to mean += 
define PRINT_x to mean printf("%d",x) 
define THEN_STOP to mean } 
define END to mean } 

One fascinating aspect of the C language is its ability to perform 
replacements of BEGIN by main() {, and LET by nothing (a "null 
string") and END by }, etc. etc. 

Before the C-compiler goes to work on your program, a C- 
preprocessor will make the appropriate replacements ... and 
(MAGIC!) the compiler gets a normal, standard, C program to 
compile. To tell the preprocessor that you have redefined certain C- 
phrases, you need only begin your program with these ^definitions. 

#define THIS and THAT 
^define BEGIN main() { 

^define DECLARE_AN_INTEGER int 
#define LET 

#define AS_LONG_AS while 

#define IS_LESS_THAN < 

#define INCREASE_BY += 

#define PRINT_x printf("%d",x) 

#define THEN_STOP } 

#define END } 

BEGIN 

DECLARE. ANJNTEGER x; 

LET x=0; 

AS_LONG_AS ( x IS_LESS_THAN 5 ) DO 

PRINT_x; 

THEN_STOP 
END 

If the above program is written and compiled, the preprocessor will 
make all replacements indicated by the various #definc statements! 

The #define statements are instructions to the preprocessor. 
We've actually seen such instructions before! Remember ^include 
<stdio.h> ?? THAT was also an instruction to the preprocessor .. 
to replace the phrase, ^include <stdio.h> by the library of standard 
input/output routines ( „ which explains why a compiled program 
is often very much larger than the program we write with our favourite 
text-editor .. it contains the i/o library of functions!). 



#lnclude <stdio.h> and #include <math.h> 

Since C is supposed to be a PORTABLE language (write a C 
program on your favourite text-editor and compile if for ANY 
computer for which you have a compiler), the standard iput/output 
routines are system dependent ... and not, strictly speaking, part of 
the language! Somebody has written the functions in stdio.h with a 
specific computer in mind... which reminds me ... the library of 
MATH functions (such as sin()) is NOT in stdio.fi. If you use them, 
be sure to #include <math.h>. 

Even Sexier #Definitions 

In the previous example we used: 

tfdefine PRINTjt printf( 4 *%d",x) 

Which meant that, to print y or print a etc. we would need more 
#definitions (like PRINT^y and PRINT_a). BUT, C is very smart 
You can include a VARIABLE in the #definition (within parentheses ! ), 
for example: #define PRINT(x) printf("%d",x) 

... and now use PRINT(y) or PRINT(a) etc and the preprocessor 
would make the substitutions to. 

QUESTION: How to teach programming to kids? 

ANSWER: Invent your own kiddie-C ! 
Let the kids write this: but have the C-compiler get this: 



BEGIN 


main() { 


LETx=0; 


intx=0; 


IF (x LESS 10) DO 


while (x<10)( 


PRINT(x); 


printf(" %d ",x); 


PRINT(SQUARE(x)); 


printfC %d *\x*x); 


NEWLINE; 


printfOVT); 


INCREASE(x); 


x+=l; 


ENDIF 


} 


STOP 


) 


... can you see what#definitions are necessary ??? These #definii 


#define BEGIN main() { 




^define LET int 




#define IF while 




#define LESS < 




#define DO { 




#define PRINT(x) printff %d " 


l ,x) 


tfdefine SQUARE(x) x*x 




#define NEWLINE printfCV") 


\ 


#define INCREASE(x) x+=l 




#define ENDIF } 




#define STOP } 




turn this: 


into this: 


BEGIN 


main() { 


LET x=0; 


int x=0; 


IF (x LESS 10) DO 


while (x<10){ 


PRINT(x); 


printf(" %d ",x); 


PRINT(SQUARE(x)); 


printfC 1 %d *\x*x); 


NEWLINE; 


printf( 4 ^ M ); 


INCREASE(x); 


x-t^l; 


ENDIF ) 




STOP ) 





Of course the kids would have to type in all those !@#$% 
^/definitions... or would they ?? 
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EPROM EMULATOR 



• Emulates ROMS (2716-27010) or 
RAMs 

• in 8- and 16- bit systems. 

• Window/menu driven interface. 
Provides 8 hardware breakpoints for 8- 

• bit systems. 

$195 (2716-27256) or $245 (2716- 

• 27010), 90 day warranty. 

•15 day money-back guarantee. 
Optional assembler, disassembler, and 



xm i ve r s ail Ivli c to | rocessor : ; ; 

► Simulates Z8, Z80, 64180, 8048, 8051 

8085, 6800, 6801, 6805, 6809, 68HC11, 

6303, 6502 & 65C02. 
'Assembler, Disassembler, & Windowed 

Symbolic Simulator. Supports on-board 

debug through RS232. 
'$100 each CPU (S&H $8) 



6809 Single Board 

► Supports SK&&tA$& ft#M. 

► Two 6821 PIAs connect 32 bits of I/O to 
outside world. 

* No jumpers for 2732, 2764, and 6116. 

* Two interrupt signals on CPU bus. 

* Size is 2.75"x5 M . $60 each board. 

» For an integrated development system 
with assembler, disassembler, and on- 
board debugger please add $70. 



68HC11 Microcontroller 
Development System 

• Eight channel 8 -bit A/D converter. 
32K ROM and 32K RAM. 

• $120 each SBC, to complete with 
assembler, disassembler, BASIC inter- 
preter and on-board debugger add $70 



J&M Microtek, Inc. 

83 Saman Road, W Orange, NJ 07052 
Tel: 201-325-1892 Fax: 201-736-4567 



CoCo-C is still available, but we 
only have about a dozen left! 

Send $25.00 (plus $2.50 S&H) 
for your copy today, and start 

learning to program in C on your 

CoCo (all models supported) 

without OS-9 ! 

FARNA Systems 

Box 321 

WarnerRobins,GA31099 



We (the master over 'C'er) would have all 
those !@#$% ^definitions in a separate file 
(on disk) called sugar.c so the kids would 
only have to begin their program with: #include 
<sugar.c> The preprocessor would #include 
all those !@#$%#definitions at the beginning 
of every program, then make all the 
appropriate substitutions/replacements ... 

We have written the #definitions using 
CAPITALS to replace C-phrases. That's 
not necessary, but ADVISABLE ( then it's 
obvious which parts of your program are 
HOME-MADE and which are "real C")! 
Not only do #defmitions allow us to write C 
in a personal dialect, but they also allow us 
to quickly change certain C-phrases. 

Notes from the author: 

On the IBM PC (with the "ansi.sys" 
program installed), I can clear the screen by 
using : printf("?[2T); 

In place of the question mark, I type an 
"escape character" by holding down the Alt 
key and typing the number 27 on the number 
pad ... and the "left-arrow** appears when I 
release the Alt key. Now, I begin my programs 
with a #definition (among others) 

#define CLEAR printf("?[2T) 
then I can use CLEAR; wherever I need it, 
in my program. 

Tomorrow, when I buy a sexier C -compiler 
for the PC (or learn more C! )... one which has 
all the features included in "ansi.sys"... 
including a clr_screen() function, I replace 
the above ^definition by: 

#define CLEAR clr_screen() 

Typedef(lnltlons) 

You begin your program with #define 
SAM int and it will be preprocessed, and 
every occurrence of SAM will be replaced by 
int... as in SAM x=0; which gets passed on 
to the compiler (by the preprocessor) as int 
x=0; 

This "replacement" by the preprocessor 
holds for anything ... not just DATA TYPES 
( so #define NewLinePlease printf(*Vi") 
allows you to use NewLinePlease; in place of 
printf("VT); ). 

BUT, there is a "special" feature for 
DATA TYPES, called typedef. Place, at the 
beginning of your program: 

typedef int INCHES (note the order!) 
... and you may subsequently use, in your 
program: 

INCHES x.y.z; 
and the variables x, y and z will be regarded 
(by the compiler) as int variables. 

typedef int INCHES (note the order!) 
doesn't seem like it's any different from: 

^define INCHES int (note the order!) 

BUT, remember the curious way we had 
to refer to an argument, passed to a function, 
which was itself a function? 



float solve(f,x, error) 

float (*f)0; (note the curiosity!) 

float x, error; 

{ 

Here, the C -phrase float (*f)0;. savs t^t 
f is a pointer to a function, and this function 
returns a float. 

float solve(f,x,error) 

float (*D0; (note the curiosity!) 

float x, error; 

{ 

Now, using typedef, we may introduce a 
home-made DATA TYPE called Pointer to 
a Function which returns a Float, 
typedef float (*PFF)() (note the order!) 

Use the above typedef (near the beginning 
of your program) and (MAGIC!) the phrase 
PFF is interpreted (by the compiler) as 
meaning a Pointer to a Function which returns 
a Float. Use it, in solve(), like so: 
float solve(f,x,error) 
PFF f; 
float x, error; 

{ 

Since typedef is more than "just a dumb 
replacement of characters", the preprocessor 
won't touch it ... but passes it along to the 
compiler! And THAT makes it different 
from a#define too! 

Typedef Char *STRING 

Here STRING is a pointer to a string and you 
may write STRING x; meaning that x is a 
pointer to a character string, 
typedef int VECTOR[5] 

Here VECTOR is an array of 5 ints and 
you may write VECTOR x; so x is an array 
of 5 integers, 
typedef int INTEGER 

Here INTEGER is an int (of course!), and 
you may write INTEGER x; ... and, when 
you compile your C program for a different 
computer where int DATA TYPES are 4 
bytes long (and you were counting on their 
being only 2 bytes long ! ) you change this one 
statement to: 
typedef short INTEGER 

meaning a "short" integer, 
and all your references to INTEGER x; and 
INTEGER y; etc. will be changed! 

< 268'm > 



P.J.Ponzo 

Dcpt. of Applied Math 

Univ. of Waterloo 

Ontario N2L3G1 

CANADA 
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Basic09 In Easy Steps Chris Dekker 

Running machine language subroutines from within Basic09. 



Once your ML subroutine is written and 
debugged, running it can be accomplished 
with a simple RUN statement in the same 
way as you run B asic09 subroutine modules. 
Before we get to that point, however, some 
work has to be done and that's today* s focus. 

Why bother with ML subroutines?? There 
are two basic reasons: Either you can't get the 
job done in Basic09 or you can't get it done 
fast enough. When presented with one of 
those problems you don'thave to go running 
for your assembler right away, though. There 
are a number of ways that may solve your 
problem quicker and easier. 

For starters you may be able to rewrite 
parts of your Basic09 program to speed 
things up (something I will deal with in a 
separate article). Your next best bet is to 
search the technical reference section of the 
OS -9 manual for a documented system call 
that will do the job. A lot of times this will 
be the case and you will only have to provide 
some pointers and/or codes to get the job 
done through the S YSC ALL utility. 

Mind you, outside these avenues there are 
plenty of occasions left to write an ML 
subroutine. A few that come to mind are: no 
system call will do the job, using a system call 
is too cumbersome, you need an improved 
version of a Basic09 function or you simply 
have to do a job that OS-9 wasn't designed 
to do. 

To get a little more specific: Let's say you 
need to move a few thousand bytes. If they 
have to be moved from one string to another 
or from one array to another you can do a 
quick and easy job with Basic09 itself. Just 
use the = operator as in scratch=buffer. 
Assuming "buffer" and "scratch" are iden- 
tical in size and type this will work fine. But 
what if one is an array of bytes, while the 
other is defined as a string? In that case 
Basic09 will generate an error and refuse to 
let you use this setup. 

So we could use the FSmove system call. 
However since this call is designed to access 
the computer *s entire memory it wants to sec 
a DAT image so it can assemble an extended 
address. Allhoughnot impossible to get, this 
makes the entire process a little too cumber- 
some for my taste. At least when it comes to 
moving some bytes inside Basic09's 64K 
address space. 

So what about simply PEEKing and 
POK(E)ing the bytes with Basic09. This 
works fine for a small array but anything 
over, say, 500 bytes will noticeably slow 
down your CoCo every time it has to copy 
the data. In real numbers: you will be lucky 
to transfer about 5000 characters per second. 



By comparison a ML routine, even with 
the overhead of starting a separate module, 
will reach transfer speeds of 30,000 to 40,000 
characters per second depending on exactly 
how it is coded. Of course a 6309 is still an 
order of magnitude faster. After setting up 
it's registers, the chip's internal hardware 
takes over, transferring data at a clip of 1 
character (or byte) per 3 clock cycles. This 
amounts to almost 600,000 characters per 
second. 

To give you some examples of other rea- 
sons for using ML subroutines: decoding 
graphics data into printer data is awfully 
slow in B asic09 because of the huge amounts 
of data that can be involved. For instance, to 
make a full color printout of a 320x 1 92 pixel 
16 color screen in 24-bit high density mode 
on my Star NX2420 printer, the computer 
generates a data stream of approximately 
31 OK bytes. Also prime candidates are data 
compression/expansion, searching buffers on 
a byte by byte basis, stripping byte se- 
quences out of textfiles, etc. 

Another good reason is to improve on 
existing Basic09 functions. For instance 
SUBSTR does a great job to search strings, 
but it is case sensitive. So what do you do 
when you need a function that is not case 
sensitive? You write one. 

The last example I want to mention is that 
of a Basic09 program that needs to know 
whether it is running on a 6809 or a 6309 
processor in a time sensitive application. No 
way of finding out in Basic09 but relatively 
easy for a ML subroutine which can pass it's 
findings back to Basic09. 

Hopefully you are by now convinced of 
the usefulness of this approach, so how to 
pull it off? As you may have noticed from my 
examples, all these applications are very 
straightforward and single purpose. This 
makes it much easier to write and debug the 
routine since it doesn't have to be very 
complicated. 

For instance, if your routine has to deal 
with data from a variety of sources, your 
Basic09 program can standardize the data 
format and store the data in an internal buffer 
that can be accessed by the ML routine. 
Likewise Basic09 can take the results from 
your ML routine and process them some 
more if necessary. 

Assuming you are somewhat familiar 
with writing assembly language, even under 
DECB assemblers like EDT ASM, we arc left 
with only one sticking point: how docs 
Basic09 pass on variables? 

Before I dig into that, there is one thing I 
want to clarify. I mentioned EDTASM be- 



cause at this level (simple subroutines) you 
don't need to be an OS-9 expert to write ML 
routines. The only thing you have to keep in 
mind is that your code must be position 
independent in order to work correctly. For 
all practical purposes: use only BRANCH 
instructions and NO JUMP instructions and 
you won't have anything to worry about. Of 
course you will need a compiler or other 
program that can assemble a correct OS-9 
format module around your code. 

So how does Basic09 pass the necessary 
variables? Actually it is really simple. Ba- 
sic09 creates a stack of 4-byte entries, sets 
the microprocessor's S register (hardware 
stackpointer) to point to the stack it just 
created and then transfers program control to 
the starting address of your ML routine. 

That's really all there is to it Returning 
control back to Basic09 is even simpler: just 
execute a RTS instruction. OS-9 finds the 
starting address by looking at two bytes 
inside the ML routine's module header but 
this, as well as some other overhead associ- 
ated with starting up a module, is completely 
transparant to the user. 

So all we are left with is to be able to 
interpret the values contained in the above 
mentioned stack. It's definitions are as fol- 
lows: [please note that all values passed are 
integers (or 2-byte values) effectively pass- 
ing 2 values per 4-byte entry] the first inte- 
ger you encounter, the one at which S points, 
is an address Basic09 needs when your rou- 
tine exits. So never change it or your pro- 
gram will crash the moment your ML rou- 
tine exits. Also make sure that the S register 
points to this address when your routine 
exits for similar reasons. So be careful when 
using BSR or other instructions that change 
the stack pointer. 

The second integer on the stack holds the 
number of variables that have been passed to 
the routine. For instance if you know that 
Basic09 must pass 3 variables, you can use 
the following code to check this out. 



ldd 2.s 


EC 62 


empd #3 


10 83 00 03 


beq init 


27 04 


ldb #56 


C6 38 


coma 


43 


rts 


39 



init ... start of rest of module 

This code will return an error 5 6 to B asic09 
if a different number of variables has been 
passed. Code 56 is dc fined as "parameter 
passing error" in Basic09. 

The rest of the stack consists of a 4-bytc 
entry for each variable passed. The lower 
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two bytes of the entry form a pointer to the 
variable, while the upper two bytes contain 
the size of the variable. You could use this 
data to make a further check, but other than 
that it is rarely used. 

So our main focus becomes the actual 
pointers. The hard part about them is that 
Basic09 has more ways than one to pass a 
variable (pointer) to a subroutine and this is 
reflected in the meaning of the pointer on the 
stack. Basically it can be a direct pointer or 
an indirect pointer. As any ML programmer 
knows this means you have to use different 
addressing modes to get to the actual variable. 
The trick is to know when Basic09 passes a 
direct pointer and when an indirect one. 

I will try to explain that without confusing 
everybody, including myself. Assuming that 
you are familiar with passing variables from 
one Basic09 module to another, one can 
safely say that if you use the same parameter 
passing conventions, most pointers to vari- 
ables are indirect ones. Most pointers to 
arrays and datastructures, on the other hand, 
are directpo inters. Keeping this in mind let's 
see why. 

DIM origin,destination,runlcngth:INTEGER 
DIM bufferl(1000),buffer2(1000): BYTE 
origin=ADDR(bufferl) \ destination 
ADDR(buffer2) runlength=500 
10 RUN move(origin .destination .runlength) 
20 RUN move(bufferl,buffer2, runlength) 

Assuming the goal is to move 500 bytes 
from buffer 1 to buffer2, let's see what hap- 
pens. In line 10 Basic09 passes the addresses 
of both buffers as separate variables. In effect 
Basic09 passes a pointer to the address of the 
variable. To get the address of buffer 1, which 
is the content of the variable "origin", we 
must treat the location pointed to by the 
value on the stack as an address. So we are 
dealing with an indirect pointer here, which 
requires indirect addressing. 

Alternately, in line 20, Basic09 passes a 
pointer to bufferl itself; rather than to a 
variable. This means that the memory loca- 
tion pointed to by the stack is the actual first 
byte of bufferl and we must use direct 
addressing to access that byte. 

So what instructions do we use to load the 
various registers with correct values? Let's 
say we want register x to point to buffer 1 and 
register y to buffer 2, so we can copy bytes 
using the auto-increment mode. The code 
used in line 20 is the more direct approach and 
easiest to understand. 
Idx 4,s AE 64 
ldy8,s 10AE68 
ldd[$c,s] ECF8 0C 

The abovecode will load all your registers 
with the correct values. 

In line 1 things arc a little more complex 



since we use indirect addressing to load 
registers x and y. This looks as follows. 
ldx[4,s] AEF8 04 
ldy[8,s] 10AEF8 08 
ldd[$c,s] ECF8 0C 

This code, too, will load the correct values 
into your registers. 

As you can see in both cases we loaded the 
number of bytes to be moved into register D. 
If it suits you better, you can also load this 
value into register U and use that as a loop 
counter. 

Please note that every time you pass a 
variable like "runlength" to a ML routine 
you MUST pick it up using indirect address- 
ing as explained above. 

Finally, I would like to pass along some 
tips that will make things somewhat easier 
for those of you who want to try this ap- 
proach: First of all if your ML routine runs 
succes fully with some programs but refuses 
to run or repeatedly crashes your computer 
with new efforts: check the type of variable 
you are pas sing to the routine. Nine times out 
of ten you will find that they are not declared 
as INTEGER. 

If you have to pass a considerable number 
of v ari ables to a routine or if the routine needs 
a "scratchpad", try setting up a user stack 
with your Basic09 program: this is much 
easier than trying to do everything inside 
your ML routine. This user stack can be 
defined as a simple array of x bytes in size or 
as a complex datastructure, which can be 
preloaded with all initialization values by 
Basic09. Load the address of the array or data 
structure into register U and you're all set. 

I wanted to finish this part of the series by 
including some code that can serve as an 
example. But what? After some consider- 
ation I decided to settle for a copying routine 
as this ties in nicely with some subjects I still 
want to discuss. Once you have such a 
routine you will find it becomes much easier 
to use data modules and/or graphics buffers 
to (temporarily) store data outside your 64K 
workspace. This way your programs can 
handle larger volumes without continually 
having to access your disk drives. 

For those "of you with an assembler I have 
included a listing with comments. For all 
others, here is the actual code including mod- 
ule headers and CRC bytes. You can save 
them as disk files in the same manner as 
described in part 3 of this series. 

To avoid undue problems I have used the 
"indirect pointer" approach. This is a little 
more work, but more versatile and consistent 
throughout all situations. So, here is the 
Basic09 code you need to call the routinc(s). 

DIM org,dcst,rlc:INTEGER 
org=ADDR(buffcrl) \ dcst=ADDR(buffcr2) 
rlc=SIZE(buffcrl) 



RUN move(org,dcst,rlc) 

[or RUN rmove(org,dest,rle)) 

Of course bufferl and buffer2 can be any 
variable or string name and rle holds whatever 
number of bytes you want to move. Keep in 
mind that any system calls used to map data 
blocks or buffers into your address space 
return a starting address for that block. You 
can access those blocks by equating org or 
dest to that starting address. 

Now for the fun part: I will give you four 
different routines. One moves bytes, the 
second moves bytes in reverse order (which 
is sometimes necessary to avoid overwriting 
data before it is copied). The first set runs 
only on a 6809, the second set of routines do 
the same job on a 6309 using it's TFM 
instructions. After all f it would be cruel to tell 
you how fast the processor is without allow- 
ing access to it's capabilities. Although it 
should be obvious, the second two do not 
work with a 6809 processor (first two will 
work with 6309). 

The last thing I want to mention here is that 
these routines do not check for errors. Your 
Basic09 program must make sure the ad- 
dresses are valid and that RLE is greater than 
zero. If you feed the routine a negative 
runlength it will run but crash your program 
in the process because it overwrites vital 
sections of your address space. 

move.6809 

87 CD 00 36 00 2E 21 81 0D 00 0D 00 

00 AE F8 04 

10 AE F8 08 EC F8 OC ED 62 5D 27 0D 

A6 80 A7 AO 

5A 26 F9 A6 62 26 02 5F 39 4A A7 62 

20 EE 6D 6F 

76E5 0191E4 22 

rmove.6809 

87 CD 00 3B 00 32 21 81 1C00 0D00 

00 26 00 ID 

30 01 10 AE F8 08 31 21 EC F8 0C ED 

62 5D 27 0D 

A6 82 A7 A2 5A 26 F9 A6 62 26 02 5F 

39 4A A7 62 

20 EE 72 6D 6F 76 E5 01 6F04 0C 

movc.6309 

87 CD 00 25 00 ID 21 81 2D 00 0D 00 

00 AE F8 04 

10AEF8 06 10A6F8 0C 11 38 12 5F 

39 6D6F76 

E5 014E95F7 

move. 6309 

87 CD 00 26 00 ID 21 81 2E000D0000 

AEF8 04 

10AEF8 06 10A6F8 0C 11 39 12 5F 39 

72 6D6F 

76E5 01 2A A0 4F 
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00001 NAM move.6809 

00002 0001 edition equ 1 

00003 0000 87CD0042000D mod 
MODEND,MODNAM f MDTYPE+ 
LANG.$81.START,MO 

00004 0020 MDTYPE equ $20 

00005 0001 LANG equ $1 

00006 0000 MODMEM equ 

00007 000D6D6F76E5 MODNAM 
fcs /move/ 

00008 * for imove: MODNAM fcs/ 
rmove/ 

00009 001101 fcb edition 
* 3 parameters? 

00010 0012 EC62 START ldd 2,s 

00011 0014 10830003 cmpd #3 

00012 0018 27(M beq INIT 

* no!! error 56 

00013 001AC638 ldb #$38 

00014 001C43 coma 

00015 001D39 rts 

00016 001EAEF804 INIT ldx [4,s] 

00017 * for rmove: leaxl t x avoid 
loosing byte 

00018 * in pre-decrement mode 

00019 0021 10AEF808 ldy [8,s] 

00020 * for rmove: leay l,y same reason 

00021 0025ECF80C ldd [$c,s] 

00022 0028 ED62 std 2,s scratchpad 

00023 002A 5D tstb rle mod 256=0?? 

00024 002B270D beq next 

00025 002DA680 loop. Ida ,x+ 

00026 * for rmove: loop Ida ,-x 

00027 002FA7A0 sta ,y+ copy bytes 

00028 * for rmove: sta f -y 

00029 0031 5 A decb countdown 

00030 0032 26F9 bne loop 

00031 0034 A662 Ida 2,s more blocks 

00032 0036 2602 bne next left to do? 

* exit without errors 

00033 0038 5F clrb 

00034 0039 39 rts 

* decrement and store blockcount 

00035 003A4A next deca 

00036 003BA762 sta 2,s 

00037 003D20EE bra loop 

00038 003F6E50AF EMOD 

00039 0042 MODEND equ * 

00000 error(s) 

00000 warning(s) 

$0042 00066 program bytes generated 

$0000 00000 data bytes allocated 

$0119 00281 bytes used for symbols 



00001 NAM move.6309 

00002 0001 edition equ 1 

00003 0000 87CD0042000D mod 
MODEND,MODNAM,MDTYPE+ 
LANG.$81,START\MO 

00004 0020 MDTYPE equ $20 



00005 0001 LANG equ $1 00006 
0000 MODMEM equ 
00007 000D6D6F76E5 MODNAM fcs 
/move/ 00008 * for rmove: MODNAM 
fcs /rmove/ • 

00009 001101 fcb edition 

* 3 parameters? 

00010 0012 EC62 START ldd 2,s 

00011 0014 10830003 cmpd #3 

00012 0018 2704 beq INIT 

* no!! error 56 

00013 O01AC638 ldb #$38 

00014 001C43 coma 

00015 001D39 rts 

00016 001EAEF804 INIT ldx [4,s] 

00017 0021 10AEF808 ldy [8,s] 

00018 0025 10A6F80C ldw [$c,s] 

00019 0029 113812 t&n x+,y+ 

00020 * for rmove: tfm x-,y- 
* exit without errors 

00021 002C5F clrb 

00022 002D39 rts 

00023 002E04F5B7 EMOD 

00024 0031 MODEND equ * 

00000 error(s) 

00000 warning(s) 

$0031 00049 program bytes generated 

$0000 00000 data bytes allocated 

$00D9 00217 bytes used for symbols 



Chris Dekker 

RR#4 

Centreville,NBE0JlH0 

CANADA 



< 268'm> 



Wildcard.bas listing 

continued from page 19 



1500 INPUT " TYPE";WN$ 

1510FORSI=0TONF 

1520:TS$=T$(SI) 

1530 :IF WN$=TS$ THEN OC<SI)=ASC 

(OPS) 

1540 NEXT 

1550 RETURN 

1560 'CASE A ORB 

1570 INPUT " TYPE #{Y/N)";WT$ 

1580 IF WT$="Y" OR WT$="a" THEN 

INP UT " TYPE";WT$:GOTO 1600 

1590 IF WT$="N" OR WT$="n" THEN 

WT $="N" ELSE GOTO 1570 

1600FORSI=0TONF 

1610:TS$-T$(SI):AF$-A$(SI) 

1620 :IF WT$o"N" THEN IF WT$=TS$ 

AND WN$=AF$ THEN OC(SI)=ASC(OP$) 

1630 :IF WT$="N" THEN IF WN$=AF$ TH 

ENOC(SI)=ASC(OP$) 

1640 NEXT 



1650 PRINT "DONE" 

1660 RETURN 

1670 'HELP 

1680CLS:PRINT:PRINT"help on wild cards" 

1690 PRINT:PRINT " THE * MEANS USE 

WILD CARDS ■ 

1700 PRINT - FOR EXAMPLE TO MARK 

ALL FILES" 

1710 PRINT " THAT START WITH A C TY 

PE C # " 

1720 PRINT " TO MARK ALL FILES THAT 

START" 

1730 PRINT " WITH CE TYPE CE* AND T 

O MARK" 

1740 PRINT " ALL FILES THAT CONTAIN 

CE" 

1750 PRINT - TYPE *CE" 

1760 PRINT:PRINT 

1770 INPUT " PRESS ANY KEY TO CONTI 

NUE -;AK$ 

1780 RETURN 

1790 'CONTAINS 

1800 WL=LEN(WN$):WL=WL-1:WS$=RIG 

HT$(WN$,WL):SF=0 

1810FORSU0TONF 

1820:FS$=F$(S!) 

1830 :SF=INSTR(1,FS$,WS$) 

1840 :IF SFoOTHEN OC(SI)=ASC(OP$): 

PRINT F$(SI);" # ";SI 

1850 NEXT 

1860 PRINT "CONTAIN "+WS$+" PRESS 

ANY KEY" 

1 870 K$=INKEY$:IFK$=""THENGOT01 870 

1880 RETURN 

1890 'STARTS WITH 

1900 WL=LEN(WN$):WL=WL1:WS$= 

LEFT $ (WN$,WL) 

1910FORSI=0TONF 

1920 :FS$=LEFT$(F$(SI),WL) 

1930 :IF FS$=WS$THENOC(SI)=ASC(OP 

$): PRINT F$(SI);- # ";SI 

1940 NEXT 

1950 PRINT "PRESS ANY KEY" 

1960 K$=INKEY$:IFK$="THEN 

GOT0 1960 

1970 RETURN 

1980 'Mark ALL 

1990FORI=0TONF 

2000:OC(I)-ASC(OP$) 

2010 NEXT 

2020 RETURN 

2030 'RUN THE FILE ORGANIZER 

2040 FOR l=0 TO NF 

2050 POKE 30200+I,OC(I) 

2060 NEXT 

2070 PRINT.PRINT "Done" 

2080 PRINT "INSERT PROGRAM DISK IN 

DRIVE";PD 

2090 PRINT:PRINT • PRESS ANY KEY" 

2100 WN$=INKEY$:IF WN$=""THEN 2100 

2110 IF PD=0 THEN RUN"SDSK512K:0*,R 

2120 IF PD=1 THEN RUN"SDSK512K:1",R 

2130 IF PD=2 THEN RUN"SDSK512K:2",R 

2140 IF PD=3 THEN RUN"SDSK512K:3",R 

2150 'HEADING 

2160 CLS:PRINT " WILD CARD BUILDER 

"PRINT • OP = ";OP$PRINT 

2170 RETURN 
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RiBBS to Go is a package of 5 dsdd 40 
track disks with a reworked OS-9 boot 
disk from what you supply. To run it 
requires a CoCo III with 5 1 2k memory, OS - 
9 Level II, upgraded MulU-pak, RS232 pak 
or equivelent, and a minimum of 2 dsdd 40 
track floppy drives. A minimum 1200 baud 
autoanswer modem is needed, but Hi-Speed 
modems can be accomodated for 9600 baud 
use. Connects at up to 16,800 will work as 
my ZyXEL modem will connect at 1 6,800 to 
another ZyXEL. 

RiBBS to Go is the latest V2.10 and can 
easily be expanded to more menus, larger msg 
base andmoved to a Hard Drive. Readme info 
to do this is included along with 2 disks with 
all docs, and a set of utilities and games. The 
other 3 disks are the boot disk and a /dd 
CMDS and /dl/FILES disk (the running 
part). RiBBS to Go will run 'out of the box* 
with IS min. of editing a few files; readme 
files describe this procedure. It is also 
recommended to install an RS232 breakout 
box between your RS232pak and modem and 
rewire the pins 6-8 reversed between the pak 
and modem. RiBBS will work without this 
but not really the best way. 
*** How to get RiBBS to Go *** 
Format 5 DSDD 40 track 5-1/4" disks with 
OS-9 Lev II. Copy or cobbler one disk with 
a copy of your boot. Put in a floppy disk 
mailer or padded mail paket with your return 
address and a check or M.O. for $5.00 for 
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News Flash!! CoCo 3 Emulator had been 
officially released!! As of today, Novem- 
ber 26, 1994, Jeff Vavasour has officially 
released his CoCo 3 Emulator. As 
one of the Beta Testers for this emulator (and 
the only Beta Tester that has tested it for OS - 
9 Level II Compatibility), I have given my 
approval of the stability and usability of the 
emulator. The other testers have done the 
same for RS-DOS functionality. 
One thing people should know about the 
emulator is that they should get the new 
CoCo 2 emulator (ver. 1.4) to run the 
VGACHECK program and test out the disk 
drive I/O before committing to registering the 
CoCo 3 emulator (VGA CHECK is on this 
issue's microdisk, OS-9 & DECB sides; it 
will require transferring to an MS-DOS disk 
before running). 
CoCo 3 Emulator Features: 

- Full CoCo 3 Basic and OS/9 Level E 
Compatibiltiy 

- Sound Card and PC Speaker support for 
CoCo DAC sound generation 

- Use of mouse, or PC Joystick for either or 
both joystick ports 

- Can use 40 or 80 track virtual disks in OS/ 
9 Level H 

- FULL REALTIME MULTITASKING!! 
That's right - real multitasking on the PC! 

- Printer fully functional in both DECB and 



- King's Quest EI 

- Koronis Rift 

- Rogue 
-OS-9 Level II 

- Multi-Vue 

- DcskMate 3 

- Sub-Etna' s Towel & Invaders 

- Most RS-DOS programs and utilities, such 
as Disk EDTASM, Color Ventures Backup 
Lightening, etc. 

The CoCo 3 emulator is available only by 
registration. Registration info is found in the 
*new* ver 1 .40 release of the CoCo 2 emu- 
lator, which should appear on SimTel FTP 
mirror sites shortly. The file is coco2-14.zip 
(*not* coco2-13.zip). One SimTel site is 
oak.oakland. edu t the directory is pub/msdos/ 
emulator. When you register your copy of 
the CoCo 2 emulator, you will be sent the 
CoCo 3 emulator disk. Once you have checked 
your MS-DOS system and verified that it 
meets the emulator requirements, you can 
send $25 to: 
Jeff Vavasour 
c/o Department of Physics 
6224 Agricultural Road 
University of British Columbia 
Vancouver, B.C. 
Canada V6T 1Z1 
Jeffs e-mail : jeffv@physics, ubc.ca 
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shipping and handling. The Package will be 
returned within a few days. Send to: 

Warren Hrach 

4369 Newport Ave. 

San Diego, C A 92107 

BBS (619) 224-4878 (RIBBS site!) 

Fido net/node 1:202/744 

Voice (619) 221-8246 

Internet (warren@ocnbcach.jd.com) 

A version of RiBBS is being worked for the 

MM/1 and K-Windows. 



68' micros now has its own Internet news 
list! To subscribe to the list, send e-mail to 
"listserv@zog.com". The message text 
should read "subscribe micros firstname 
las tname", using your real first and last name. 
If you need a list of die commands supported 
by the list server, send another message to the 
same address with the message being the 
word "help". You will be sent a copy of the 
help file, usually by die next day. E-mail may 
also be sent to the editor at "microcd@zog, 
com" as well as "dsrtfox® Delphi.com". 



OS-9 Level n 

- All CoCo 3 Colors and video modes fully 
functional 

- ROM, Virtual Disk, and Virtual Tape 
menus 

- Improved Menu driven File Port Utility can 
be called up and used within emulator. 
There is much more. This emulator will 
function just like the CoCo 3 and will do so 
right on your own PC compatible! 

What you will need: 

- PC Compatible (286 w/640K minimum 
required; 3 86SX/1 6 or higher recommended; 
at least 384K of EMS memory required for 
5 1 2K emulation - 1 28K without EMS; VGA 
graphics. 

- PC Sound Card (Optional - required for 
sound) 

- Mouse (Joystick optional) 

- CoCo 3 ROM and Disk Basic ROM from 
Disk Drive ROMPak (Instructions on get- 
ting the ROMs transferred from your disk 
based CoCo 3 system is included in the 
emulator package) 

Some of the many Programs found to run 
with the emulator: 



FOR SALE : Coco 3, excellent condition, 

with like-new CM-8 monitor, two DS 

floppies, all OS -9 public domain library, OS- 

9 levels 1 and 2, many, many programs and 

ROM packs, 2400bps external modem w/ 3 

way serial port switch and cable, all manuals, 

Rainbow magazine from 1984 to final issue; 

Multi-Vue, 512K upgrade, 6309 w/socket 

and B&B PowerBoost software (not yet 

installed), joystick, X-pad, no HD or 

Multipak. E-mail at dlockman@pacificr. 

com, voice mail at 206-750-5266, voice at 

206-896-4000, or drop a line to 151 12 NE 

34th Street, Vancouver, WA 98682-8315. 

$300 obo takes all! 
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from my family to 

yours, I wish you all a 

very merry holiday 

season and a happy 

(and safe!) new year! 

the editor 
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NEW PRODUCTS 

from 

FARNA Systems! 



CnCo Family Recorder/OS-9 1.0 

If you are into genealogy, then the CoCo 
Family Recorder is the absolute best 
program for the CoCo 3. The OS -9 
version is nearly identical to the DECB 
version in appearance, but takes 
advantage of many OS-9 features 
such as pop-up windows for entering 
data. DECB users can send their 
original CCFR disk (it will be returned) 
to get the OS-9 version for only 
$20.00. Others must pay the regular 
price of $28.50. Requires at least one 
40 track double sided drive (FD-502) 
or larger. Can be shipped on 3.5" 
720K disk if requested. 



FARNA Systems 

Box 321 

Warner Robins, G A 31099 

$2 JO shipping and handling per order. 
Canada S&H $4.00; Overseas $7.00 



NOTICE: WE CAN NOW 
ACCEPT CREDIT CARDS!!! 
Visa and MasterCard (only!) 

can now be accepted for payment. 
There is a 6% service charge (but a 
maximum of $10) since cards are 
accepted through a third party. Cards 
will be billed through "FS Printing". 



GREAT FIND! 

We have recently pur- 
chased 1 BRANDNEW 
double sided forty track 
drives from a local ven- 
dor. Hecouldn'tusethem, 
so I can pass them to you 
at a used drive price of 
only $15 each, shipping 
included! Remember, I 
only have ten, so act fast! 



FAKsMystems 



Box 321 

WamcrRobins,GA31099 

Phone912-328-7859 

Internet: dsrtfox(2> delphi.com 



Software* Books* and Hardware for all OS-9/OSK Systems} 



CoCo DECB Software: 
CoCo Family Recorder - $17.50 

Genealogy program for CoCo 3. Requires 2 
drives, 80 col. monitor. 
NEW! OS-9 Version - $32.50 

DigiTechPro - $12.50 

Sound recorder for CoCo3. Record any sound 
for easy play- back in your BASIC or M/L 
programs. 

ADOS: Support for double sided drives, 40/80 
tracks, faster formatting, much more! 
Original (CoCo 1/2) - $15.00 
ADOS 3 (CoCo 3) - $25.00 
Extended ADOS 3 - $30.00 (ADOS 3 req., 
RAM drives, support for 512K-2MB) 
ADOS 3/Ext Combo - $50.00 

Mind Games - $7.50 
Collection of 9 classic games. Run from in- 
cluded RAM disk w/ 51 2K. 

Cross Road II - $7.50 

Simple Tic-Tac-Toe, but with amazing sound 

and graphics! Sound recorded with Digi-Tech. 

Space Intruders - $14.50 
Looks just like Atari's classic "Sapce Invad- 
ers"! CoCo 1/2 and 3. 
Donut Dilemma - $14.50 
Climb, jump, and ride elevators to top of Donut 
factory to shut it down! 10 levels. CC 1,2,3. 
Rupert Rythym - $14.50 
Collect Rupert's stolen notes, then work our 
correct sequence. Great action adventure! Get 
Space Intruders, Donut Dilemma, and 
Rupert Rythym for only $33.50! Save $10! 



CoCo O S-9 Soft w are; 

Patch OS-9 . $7.50 

Automated program installs most popular/ 
needed patches for OS-9 Level II. 512K and 
two 40T/DS (or larger) drives required. (128K 
/35T users can install manually- state 557.) 

OS-9 Point of Sale - $62.50 

Maintain inventory, print invoices, customer 
catalog, etc. Multi- user capable under Level II. 
Supports ASCII terminals. Basic09 required. 
Simple menu driven interface. 

Books: 

Tandy's Little Wonder - $22.50 

140 page softbound book with history and 
technical info for all CoCo models. Schemat- 
ics, peripherals, upgrades, modifications, re- 
pairs, much more- all described in detail! 
Vendors, clubs, BBSs also listed. 

OS-9 Quick Reference Guides Level II 
(Revision 2) - $7.50 
68K (based on 2.3) - $10.50 
Get that bulky manual offyour desk! These 
handy QRGs have all the most needed informa- 
tion in a 5.5"x 8.5" desk-top size. Includes 
command syntax, error codes, special keys 
functions, etc. 

CqCq Hardware; 

DigiScan Video Digitizer - $150 

Capture images from VCR, camcorder, or TV 
camera No MPI required- uses joystick ports. 
CoCo Max3, Max 10, Color Max 3 compat- 
ible. Special order- allow 90 days for delivery. 
Send $75 deposit 
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Ken-Ton SCSI Hard Drive 

Complete, ready to run, "plug and play" 85MB 
system. Top quality drive, case, and ps. Send 
how much space for DECB, OS-9 --- $550.00 
No-Drive Kit: controller, OS-9 drivers, RGB- 
DOS in ROM, 2 pos. "Y" cable, and drive cable 
(specify type). Seagate N series drive with 
ROM rev. 104 or greater needed. — - $250.00 
(state how much of drive to be used for OS-9) 



System and Components 

Controller only $135.00 

OS-9 Drivers $25.00 

RGB-DOS (for DECB access) $35.00 

** $50 for RGB-DOS and OS-9 drivers when 

purchased together with a controller ** 
"Y" cable, $25 for two position, $35 for three. 
Drive cables - specify direct to drive or SCSI 
case type connector $25.00 



Add $2.50 S&H per order. Canada/Mexico add $4.00; Overseas S7.00 



FARNA Systems Publishing Services 



Type Setting and Printing: We can prepare 
professional typeset manuals, books, booklets, 
catalogs, and sales flyers for you - we can print 
or you reproduce as needed from a master set! 
Very reasonable prices - inquire! 



Mailing Service: If you send catalogs or 
letter correspondence to 200 or more persons 
at once, we can do all work for you for about 
the same cost of your materials alone! How 
much is your time worth??? 



Contact Frank Swygert at above address/phone for quotes 
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for all your CoCo hardware needs, connect with 



CoNect 



449 South 90th Street 

Milwaukee, WI 53214 

E-mail: rickuland @ delphi.com 



NEW PRODUCT: The Cube 

This tower enclosure was designed specifi- 
cally for the CoCo and peripherals, even an 
MPI if desired! Four drive bays, two will 
hold a pair of 3.5" drives sideways. Easy 
access, carry handle mounted on top! 



r"" v ' 
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Mini RS-232 Port: Don't let the name fool you! This is a full 
featured serial port, supporting the signals needed for flow control as 
well as the basic 4. Jumper blocks allow readdressing or swapping 
DSR/DCD. No custom cables or hardware widgets needed here! Y 
cable users will need to add $9.95 for a power supply. $49,95 

Hitachifi Cation; CoNect will install aHitachi63B09E CPU 
and a socket into your CoCo. Machine MUST be in working 
condition! The 68B09E will be returned unharmed. 90 day limited 
warranty. Chip and installation only $29.95 
REPAIRS: We can repair most damaged CoCos, even 
those with bad traces where a 68B09 was removed. Costs 
vary with damage. Bad 68B09 sockets repaired for only 
$40! Inquire BEFOREsending your computer. 



DISTO Products 

Quality hardware for your Color Compute^ 



2MB Upgrade (no RAM) - $99.95 

Mini Disk Controller - $70 

Super Controller I - $100 

Super Controller II - $130 

MPROM Burner - $50 

3-N-l (parallel, RS-232, RTC) - $75 

SASI/SCSI Hard Disk Adapter - $75 

Full Turn of the Screw - book with all 

Tony DiStefano's Rainbow articles, 

January 1983 to July 1989 - $20 

Complete Schematic Set - all DISTO product 

schematics except 2MB upgrade - $20 

Include $2 S&H for book or schematics. 

Hardware S&H is $4.50 for one item, 

$6.50 two or more. Certified check or 

International Money Order only! 

Running low on some items- please call for availability/ 

514-747-4851 



DISTO 

mODePatie, 

St. Laurent, QC H4L 4A8 

CANADA 



By arrangement with StrongWare, Sub- 
Eiha Software is proud to bring you... 

Soviet Bloc - Called the best Tetris(tm)-like 
game by many, this is a bigger version of the 
now-classic falling shapes puzzle game. 
RS-DOS Req: CoCo 3, Joysuck/Orchestra- 
90 Pak optional $19.95 

GEMS - "Columns" of colors fall as you 
change the order of the colors. Match three 
in a row, column, or diagonal at the bottom 
and those colors disappear. Sounds simple, 
doesn't it? RS-DOS Req: CoCo 3, Joystick/ 
Orchestra -90 Pak optional $24.95 

Copy Cat - Simon says "match the sequence 
of tones as the colored diamonds flash". 
Great for building memory skills. RS-DOS 

Req: CoCo 3 $ 9.95 

OSIC Req: MM/1 or 100% K-Windows 
Systems $14.95 

HFE (Hprint Font Editor) - A fantastic editor 
for those HPRINT fonts with lots of options. 
Create your own character set which you 
can LOADM and us in your own programs. 
Also creates and edits fonts compatible 
with MiniBanncrs! RS-DOS Req: CoCo 3, 
Joystick optional $19.95 

Font Collection - A collection of 18 useable 
HPRINT or MiniBanncrs fonts. (Importable 
to OS-9 for use with MiniBanners09 as 
well!) RS-DOS Req: $ 9.95 





Towel! V1.01 by Allen Huffman - NEW VERSION! 
A program no intcrgalactic hitchhiker should be 
without! Use mouse or keyboard hot -keys to perform 
common disk and file commands from pull-down 
menus. Tag multiple files for Copy, Delete, Rename, 
etc., and even point 'n click a Backup, Cobbler, 
Dchcck, or whatever. User definable menu for 
custom options. Runs under the EthaWin interface 
(included) on a high-speed text screen. All 
commands/colors configurable. OS9 Req: CoCo 3, 
OS-9 Level 2 $19.95 



Sub-Etha Software Add S2.50 S&H. Texas 
P.O. Box 152442 residents add 8.25% tax. 
Lufkin, TX 75915 Write us for more info! 



Sub-Etha Originals: 

MultiBoot V1.03 by Terry Todd & Allen 
Huffman - Type "DOS" and bring up a list of 
up to sixteen OS9BOOT files! No more 
floppy swapping. A serious must-have for 
intense OS-9 users. OS9 Req: CoCo 3, OS- 
9 Level 2 $19.95 

1992 CoCoFest SIMULATOR VI. 02 by Allen 
Huffman - NEW VERSION now uses 
compressed graphics and has scoring. 
Take a walking tour of the '92 Atlanta 
CoCoFest with this graphics adventure. 16- 
level digitized photos of the event and a text 
parser (ie, "get the box of disks") to let you 
interact. Runs on a 640x192 graphics 
screen. OS9 Req: 512K CoCo 3, OS-9 Level 

2, 500K+ of Disk Space $ 9.95 

OSK Req: MM/1 or 100% K-Windows 
System $14.95 

Write-Right by Joel Mathew Hegberg - 
Featurcful word processor for the MM/1 
with what you would expect from a "real*' 
word processor. What you see is what you 
get! $54.95 

Etha-GUI by Joel Mathew Hegberg - A neat 
program launcher for the MM/1 which 
includes handy desktop utilities like a phone 
dialer and nifty screen savers. ..even a 
trash can. Point and click icons to run 
programs. $34.95 
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Quality OS-9 Software from 

ColorSystems 

NEW! K-Windows Chess for MM/1 

Play chess on your MM/1 $24.95 

NEW! X-10 Master Control for MM/1 

Use MM/1 to control you home! $29.95 

Variations of Solitaire 

Pyramid, Klondike, Spider J'oker and Canfield 

MM/1 $29.95 CoCo3 $19.95 

OS-9 Game Pack 

Othello, Yahtzee, KnightsBridge, Minefield, 

and Battleship 

MM/1 529.95 CoCo3 $19.95 

WPS hell 

An OS-9 Word Processing Point and Click Interface 

CoCo3 $14.95 

Using AWK with OS-9 

Includes V2.L14 of GNU AWK for OS-9/68000 

MM/1 $14.95 

To order send check or money order to: 

Color Systems 

P.O. Box 540 

Castle Hayne, NC 28429 

(916) 675-1706 

Call or write for a free catalog! Demo disks also available. 

NC Residents please add 6% sales tax 

Owned and operated by ZacK C. Sessions 



Summertime is "off " season for a lot ofCoCoists. If you 
are one of those, look forward to new releases and 
upgrades this fall If you use your CoCo all year 'round, 
the following titles are currently available: 

CoCoTop version 1 .0 $24.95 

CoCoTop version 1.1 $19.95 

CoCoTop 1.1 + Tools 3 $34.95 

OScopy/RScopy $10.00 

TOOLS 3 version 1.1 $29.95 

Quickletter version 2.0 $19.95 

Accounting level 2 $34.95 

Investing level 2 $24.95 

Level II graphics 1 .2 $34.95 

Upgrades Only $5.00 (return original disk) 

Shipping+handling: US/Canada $3.00 all others $5. Prices in US 
dollars Send cheque or money order NO COD'S. Call or write for 
Canadian dollar prices. Mention the name of this magazine in your 
order and you will receive a free bonus disk! 



C. Dekker ••• 

RR #4 Centreville, NB 

E0J1 HO, CANADA 

Phone 506-276^841 



User-friendly Level II 
Programs! 



o 



J 



EDTASM6309 Version 2.02 $35.00 

This is a major patch to Tandy's Disk EDTASM to support Hitachi 
6309 codes. Supports all CoCo models. CoCo 3 version uses 80 
column screen. 2MHz. YOU MUST ALREADY OWNTAND YS 
DISK EDTASM TO MAKE USE OF THIS PRODUCT. It WILL 
NOT work with a disk patched cartridge EDTASM. 

CC3FAX $35.00 

Extensive modification to WEFAX (Rainbow, 1985) for 512K 
CoCo 3. Uses hi -res graphics, holds full 15 min. weather fax image 
in memory. Large selection of printer drivers. Requires shortwave 
receiver and cassette cable (described in documentation) 

HRSDOS $25.00 

Move programs and data between DECB and OS -9 disks. Supports 
RGB-DOS for split DECB/OS-9 hard drives. No modifications to 
system modules (CC3Disk or HDisk) required. 

DECB SmartWatch Drivers $20.00 

Access your SmartWatch from DECB! New function added to 
access date/time from BASIC (DATES). Only $15.00 with any 
other purchase! 

RGBOOST $15.00 

Make the most of your HD6309 under DECB! Uses new 6309 
functions for a small gain in speed. Compatible with all programs 
tested to date! Only $10.00 with any other purchase! 



Robert Gault 

832 N. Rcnaud 

Grossc Pointc Woods, MI 48236 

313-881-0335 

Add $4 shipping & handling per order 



Peripheral Technology 
Specials 

486SLC/33MHz Motherboard w/CPU $139.00 

486SLC/50MHz IBM, ISA.CPU, OK $199.00 

486SLC/66MHz IBM, VESA, CPU, Math $299.00 

IBM boards - Made in USA - 3YR warranty 

1MB SIMM 70ns DRAM $47.00 

356MB Samsung IDE Drive $229.00 

420MB Connor IDE Drive $275.00 

S46MB Maxtor IDE Drive $379.00 

IDE/Floppy/Scrial/Parallel $24.95 

1.44MB TEAC Floppy $49.95 

Mini Tower, 200W, LED readout $79.00 

Panasonic Dual Speed CD ROM $169.00 

VGA Card ET4000-1MB, 1280x1024 $99.00 

VGA Monitor WEN .28mm 1024x768 $249.00 

UPS Ground $7.00 on most items except Tower & 
monitor ($1 2.00 UPS Ground). 

1250 E. Piedmont Rd. 4041973-2156 
Marietta, GA 30062 FAX: 4041973-2170 
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The OS-9 

User's Group, 

Inc. 

Working to support OS-9 Users 

Membership includes the Users Group newsletter, 
MOTD, with regular columns from the President, 
News andRumors, and^Straightfrom the Horse's 
Mouth", about the use of OS-9 in Industrial, 
Scientific and Educational institutions. 

Annual Membership Dues: 

United States and Canada Other Countries 
25.00 US 30.00 US 

The OS-9 Users Group, Inc. 

6158 W. 63d St Suite 109 

Chicago, IL 60638 

USA 



Northern Xposure ^£X£?' 



OS-9 Level II Color Computer 3 Software — ^ — — - 
NitrOS-9 v 1 .20 Call or write for upgrade info or $29.95 

new purchase procedure. Requires Hitachi 6309 CPU 
Shanghai:OS-9 Introductory price $25.00 

Send manual or RomPak to prove ownership 
Thexder:OS-9 Send manual or RomPak to prove ownership $29.95 
Smash! Breakout-style arcade game $29.95 

Rusty Launch DECB/ECB programs from OS-9! $20.00 

Matt Thompsons SCSI System v2.2 'ItfliesP $25.00 

256/512 byte sectors, multipak support 



Disk Basic Software — — — - ^ — 
Color Schematic Designer v3.0 New lower price $30.00 

Oblique Triad Software Write for catalogue 



Color Computer 3 Hardware — ^ — — _— - — 
Hitachi 6309 CPU (normally 'C model, may be *B f ) $15.00 
SIMM Memory Upgrade Runs Cooler! 512k $44.95 OK $39.95 
Sound Digitizing cable $15.00 



OS-9/68000 Software 

OSTerm 68K v2.2 External transfer protocol support $50.00 

TTY/ANSIATIOO/K-Windows/Binary Emulation 

Upgrade from TasCOM (Send TasCOM manual please) $30.00 



7 Green boro Cres 

Ottawa, ON KIT 1W6 

CANADA 

(613)736-0329 

Internet mail: cmckay@northx.isis.org 



All prices in US. funds. 
Check or MO only. 
Prices include S&H 



r "\ 

From our 

family to 

yours, please 

have a very 

merry and safe 

Christmas and 
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Or, for less demanding requirements, the 

SYSTEM IV 

The perfect low cost, high-quality and high performance OS -9 computer serving customers world- 
wide. Designed for and accepted by industry. Idea! low-cost work-station, development platform, 
or just plain fun machine. Powerful, flexible, and inexpensively expandable. Uses a 68000 
microprocessor running at 16 MHz. 
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: : ;; and prir uers. These niay be display^ on tile screen by using the ' Alt key arid one or two ^&&ys(ji^jxm§ 



Optional G-WINDOWS provides three screen resolutions: 640 x 480 x 256, 800 
x 600 x 256 ; or 1024 x 768 x 256. You can have two full size 80 x 25 windows 
with room to spare. Or, a window as large as 122 x 44 using th? large fonts or 
one over 180 x 79 using the small fonts 
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